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Prólogo al contenido 


Una de las características del ser humano es que necesita comunicarse, casi tanto como ali- 
mentarse. Desde tiempos inmemoriales, se ha dedicado a la invención de sistemas para llevar 
a cabo este mandato de la especie. El desarrollo de estos sistemas, por lo general, ha segui- 
do un camino propietario, de altos costos y extrema complejidad, hasta la llegada de Asterisk. 
Este sistema resulta un punto de inflexión en la historia de esta tecnología. Si bien su complejidad 
es importante, no lo es tanto frente a las implementaciones convencionales. Además, el hecho de 
ser un software libre lo vuelve muy atractivo, en especial, para las empresas pequeñas y medianas. 
En este libro exploraremos algunos conceptos básicos de este producto, con la intención de que 
sea una guía de acceso al mundo de Asterisk. El lector deberá contar con algunos conocimien- 
tos de telecomunicaciones y alguna práctica con el sistema operativo Linux para aprovecharlo al 
máximo. Esperamos que esta obra sea una puerta de entrada al mundo de Asterisk. 
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Introducción 


Asterisk es una aplicación que permite la im- 
plementación de centrales telefónicas. Su fun- 
ción básica es convertir un hardware en una 
plataforma de comunicaciones de voz real- 
mente poderosa. Se trata de un software muy 
flexible, que puede instalarse en casi cualquier 
sistema Linux y en algunos otros sistemas ope- 
rativos, como FreeBSD. 


Su potencia dependerá de las características del 
hardware de cómputo empleado. Por eso, po- 
dremos armar una central telefónica adecuada 
a cualquier necesidad aumentando la inversión 
en el hardware, según sea requerido por el cre- 
cimiento, y manteniendo siempre la misma pla- 
taforma básica. 


Este software es de libre acceso, y la plataforma 
que con él podemos armar tendrá todas las ca- 
racterísticas de los productos comerciales, que 
poseen un costo a veces prohibitivo para algu- 
nas empresas y son definitivamente muy altos 
para una aplicación hogareña. 


Para que quede claro: con Asterisk podremos 
armar e instalar una central telefónica para 
nuestra casa, pyme, colegio, empresa, etc. Cada 
una de estas implementaciones se diferencia- 
rá en cuanto al hardware, pero todas reutiliza- 
rán la experiencia y el trabajo realizado en cual- 
quiera de ellas. 


El proyecto Asterisk se inició en 1999, cuan- 
do Mark Spencer, su creador, publicó el 





ar a Fr 


n_n Mark Spencer, Founder and CTO 


Figura 1. Podemos conocer más sobre Mark 
Spencer en el sitio www.digium.com/en/ 
company/bios.php?uid=1. 


código inicial bajo licencia de código abierto 
GPL. Desde entonces, ha sido perfeccionado y 
testeado por una comunidad siempre en au- 
mento, que también le ha sumado nuevas ca- 
racterísticas. En este momento, Asterisk es man- 
tenido gracias a los esfuerzos combinados de 
esta comunidad y la empresa Digium, fundada 
por Mark Spencer para dar soluciones alterna- 
tivas de telefonía. 


Dimensionar 
la plataforma 


Asterisk es una aplicación que trabaja en tiem- 
po real, o más bien, con datos cuya naturaleza 
es de tiempo real; con esto nos referimos a la 
voz O la conversación entre dos o más personas. 
De esta manera, los requerimientos de recur- 
sos son importantes y hacen que la competen- 
cia con otras aplicaciones no sea deseable. Si 
en un sistema en el que está corriendo Asterisk, 
tenemos que ejecutar otras aplicaciones, 
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Dimension 





relacionadas o no, estas tendrán que hacerlo 
con un nivel de prioridad más bajo, puesto que 
las necesidades de Asterisk son rigurosas en lo 
que a cómputo se refiere. No obstante, esto no 
significa que precisemos una supercomputado- 
ra para ejecutar la aplicación, con múltiples co- 
res; sino que Asterisk debe tener el procesador 
disponible cuando lo requiera, y esto es algo 
que sucede con frecuencia. Si podemos dedicar 
una máquina para ejecutarlo, nos ahorraremos 
muchos contratiempos. 


El parámetro fundamental para dimensionar un 
sistema Asterisk es el número de llamadas o ca- 
nales simultáneos que necesitamos o espera- 
mos tener. La cantidad de terminales/usuarios 
del sistema impactará en el dimensionamiento 
de otro factor de hardware (las placas emplea- 
das para la conexión de troncales y dispositivos 
analógicos), en caso de que nuestro sistema se 
vincule a la red telefónica convencional. 


REQUISITOS DEL SISTEMA 

Para un sistema pequeño, de no más de 6 ca- 
nales, una máquina con un procesador de 
400 MHz y 256 MB de memoria será sufi- 
ciente. Si nuestro sistema es para una empre- 
sa y el requerimiento es de más de 30 canales, 





precisaremos una instalación con múltiples ser- 
vidores Asterisk que interactúen entre ellos, y 
los procesadores deberán tener varios cores, 
con más de 1 GB de memoria por máquina. 


Las instalaciones grandes suelen desarrollar- 
se con múltiples servidores interconectados en- 
tre sí y comunicados vía un protocolo denomi- 
nado DUNDI, que trabaja en una arquitectura 
detallada en la especificación ARA (Asterisk 
Realtime Architecture). El diseño y la imple- 
mentación de este tipo de soluciones no están 
dentro del alcance de este libro, y es materia 
de personal experimentado tanto con Asterisk 
como con la telefonía. 


La flexibilidad de Asterisk permite obtener solu- 
ciones muy efectivas y eficientes para cualquier 
tipo de empresa, aun las que tienen alta tasa 
de crecimiento y no pueden abordar los costos 
de una gran central telefónica hoy, pero que la 
necesitarán pronto. Las soluciones basadas en 
Asterisk son altamente escalables y ajustadas 
al presupuesto del usuario. 


En este punto vamos a explicitar el alcance de 
la presente obra. Si bien Asterisk permite armar 
complejas estructuras, incluso interconectadas 


DIGIUM 





Asterisk es utilizado en todo el mundo por pymes, grandes empresas, call centers, pro- 
veedores de comunicaciones y gobiernos. Es un software libre y de fuente abierta ( 


), patrocinado por ( 
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con la red de telefonía básica, nos centraremos 
en un sistema destinado a la conmutación entre 
clientes conectados a una red de datos, que sea 
local de área amplia. En una ampliación poste- 
rior, trataremos la interconexión con redes de 
telefonía básica. 


Selección 
del hardware 


El desempeño confiable de un sistema Asterisk 
depende de la cuidadosa selección de los com- 
ponentes de hardware, en especial, de la plata- 
forma de cómputo. Elementos clave en esta se- 
lección son la CPU, la placa madre y la fuente 
de alimentación. 


Como mencionamos, la cuestión de la poten- 
cia está relacionada con la cantidad de llama- 
das simultáneas que el sistema debe ser capaz 
de sostener. Desafortunadamente, no contamos 
con una tabla que estipule los valores o rangos 
a utilizar tipificados por nivel de desempeño re- 
querido, puesto que este, como en muy pocas 
situaciones, depende de la aplicación y el uso 
que se le dará al sistema. 


O PROYECTOS ASTERISK 


Sin embargo, podemos inferir algunas reglas 
de selección conociendo la manera en que 
Asterisk utiliza el sistema. De estas observacio- 
nes, se ha determinado una fuerte correlación 
entre la potencia de cómputo requerida y la 
utilización de características especiales, como: 


e La conferencia y el número de participantes 
en ella. 

e El uso de lógica externa a la programación in- 
terna de Asterisk. 

ela interconexión con la 
convencional. 

e El número de canales simultáneos a tra- 
tar, debido a la carga de cómputo de la im- 
plementación de los códecs en el proce- 
samiento digital de la señal telefónica. 


red telefónica 


Se tiene una percepción cualitativa de los 
efectos de estos elementos sobre el desempe- 
ño global del sistema, y las conclusiones ob- 
tenidas nos conducen a que debemos prestar 
especial atención a la selección de los distin- 
tos códecs, el tipo, el desempeño y la imple- 
mentación de la unidad de punto flotante del 
procesador bajo estudio, la latencia del servi- 
cio de interrupciones y las optimizaciones del 
kernel que se empleará. 





Existen numerosos proyectos en torno a Asterisk que facilitan su instalación. Si bien dan 
la posibilidad de armar una PBX rápidamente, no permiten un aprendizaje profundo y de- 


tallado de los procesos de instalación y de las particularidades del producto Asterisk. 





10 


RedUSERS: 





Selección del hardware 








LA CPU 

A los efectos prácticos, los procesadores mono- 
núcleo actuales tienen FPUs que cumplen con 
los requisitos de Asterisk y permitirán imple- 
mentaciones de hasta una docena de termina- 
les con capacidades telefónicas. Es posible en- 
contrar ejemplos de montajes de Asterisk en 
una gran variedad de dispositivos, donde siem- 
pre la cuestión pasa por la carga de llamadas si- 
multáneas. Como ejemplo, se sostiene que con 
procesadores Intel de hasta 700 MHz de re- 
loj puede implementarse un sistema pero con 
bajas cargas; esto es, a lo sumo, dos llamadas 
concurrentes. En este caso, más núcleos brin- 
dan beneficios, especialmente por las múltiples 
FPUs. Pero existe evidencia de que sistemas so- 
bre múltiples servidores trabajan mejor que so- 
bre múltiples núcleos, aunque la implementa- 
ción de estos es más compleja. 


LA PLACA MADRE 

La selección de una placa madre pasa por los 
detalles, dado que actualmente la mayoría de 
ellas cumple con los requisitos básicos para 
montar un sistema Asterisk. Pero los detalles re- 
sultan de vital importancia, en especial, cuando 
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Figura 2. Ambas marcas 
de procesadores sirven 
para estos propósitos. 


deseemos interconectar el sistema con la red te- 
lefónica o con PBX convencionales. En este sen- 
tido, el elemento clave es el tipo de bus que 
tiene la placa. Como el PCI es el más difundi- 
do, tendremos que poner atención a los chip- 
sets que lo implementan. Los de Intel y NVIDIA 
son muy recomendados. No obstante, no está 
de más analizar información sobre el producto 
que se tenga o que se desee adquirir, buscan- 
do cuestiones acerca de problemas relaciona- 
dos con la latencia en el tratamiento de las in- 
terrupciones (IRQ). Asimismo, será deseable que 
el BIOS de la placa permita un manejo discre- 
cional de la asignación de IRQ. 


Si la placa tiene incorporado el acceso a red, 
podemos utilizarlo, pero siempre será mejor te- 
ner una placa separada y utilizarla, para mini- 
mizar el riesgo de que un problema que afec- 
te al puerto de red termine por inutilizar toda 
la placa madre. 


LA ALIMENTACIÓN DE ENERGÍA 

En cualquier sistema de comunicaciones, la ca- 
lidad de la alimentación eléctrica de los equi- 
pos es de fundamental importancia, y Asterisk 
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no es la excepción. Las fuentes de alimentación 
de alta gama que se comercializan para el ar- 
mado de sistemas multimedia (en general, esta- 
ciones de diseño o de juegos de alto nivel) serán 
las indicadas para formar parte de nuestro sis- 
tema. Esto no significa que una fuente conven- 
cional no sirva, sino que el hecho de tener una 
alimentación de energía limpia y de buena ca- 
lidad redundará en una mejor experiencia para 
los usuarios del sistema y nos ahorrará mucho 


O APLICACIONES DE ASTERISK 


Figura 3. Lo 
recomendable es 
utilizar una fuente 
de alimentación de 
última generación. 


esfuerzo en la resolución de problemas induci- 
dos por fallas en la alimentación. 


En los sistemas empresariales de gran tama- 
ño, es común disponer de fuentes de alimen- 
tación redundantes para asegurar la disponibi- 
lidad ante un problema en alguna de ellas. Para 
enfrentar el corte del suministro de energía, 
es conveniente disponer de una UPS. Además 
de su autonomía, es importante que provea el 





Tanta gente trabajando en el proyecto ha contribuido a que Asterisk sea muy robus- 
to en muchas aplicaciones de diferentes contextos. Estas van desde centrales PBX 


estándar, hasta la implementación de complejas soluciones para contact centers. 
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servicio de acondicionamiento del suministro. 
Estos dispositivos son más caros, pero ofrecen 
protección a través de un transformador de ais- 
lación que nos separa en forma segura de los 
ruidos de la línea de la compañía. 


Como en cualquier instalación de aparatos eléc- 
tricos, disponer de un plano de tierra seguro y 
parejo nos devolverá la inversión y nos evita- 
rá muchos problemas. Es recomendable que 
la instalación eléctrica esté implementada por 
personal certificado. Al menos, deberíamos ase- 
gurarnos de no estar en presencia de lazos de 
retorno por tierra, que el circuito de alimen- 
tación sea independiente de otros (un tendi- 
do desde el panel de acceso eléctrico hasta el 
conector de alimentación de pared) y que solo 
nuestro servidor esté conectado a él. 


Asterisk por dentro 


Asterisk maneja los elementos que se conectan 
a él de la misma manera, ya sea que se trate 
de líneas terminales (conocidas como líneas de 
abonado, es el aparato telefónico del cliente) o 
troncales de interconexión, con otros sistemas 
Asterisk o PBX o la red pública. 


Desde el punto de vista operativo, esto es muy 
útil. Este manejo desinteresado se realiza a tra- 
vés del recurso lógico denominado canal, que, 
conceptualmente, es independiente de las di- 
ferencias que existen entre estos tipos de co- 
nexión. Todo el tráfico que ingresa o egresa del 
sistema Asterisk pasa a través de un canal de 
ciertas características o tipo de canal. Habrá di- 
ferentes tipos de canales, pero Asterisk los ma- 
nejará de forma similar. 


La arquitectura del software se compone de 
módulos que se cargan por demanda (según 
las características que requiera la solución) y 
se combinan con el módulo núcleo de Asterisk. 
La carga o no de estos módulos depende del 
contenido de un archivo de configuración de 
Asterisk, /etc/asterisk/modules.conf, cuyo 
manejo será tratado en el Capítulo 2. 


Algunos de estos módulos son los que im- 
plementan los códecs, las aplicaciones de 
Asterisk, el Dialplan, el registro de even- 
tos, el registro de llamadas, etcétera. 
Cabe señalar que es posible iniciar Asterisk 
sin cargar ninguno de estos módulos, y lue- 
go, a través de comandos de carga y descar- 
ga, manejarlos en tiempo de ejecución. Esta 


COMUNIDAD ASTERISK 


Si deseamos explorar productos y aplicaciones de software, hardware y soluciones 
de comunicaciones completas para los negocios, implementados con Asterisk por los 
miembros de la comunidad, podemos visitar el sitio 
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es una herramienta muy útil cuando se im- 
plementa un sistema, se ajusta uno que está 
en fase de preproducción o, simplemente, se 
intenta diagnosticar problemas en un siste- 
ma productivo. 


ESTRUCTURA DE DIRECTORIOS 

A la hora de trabajar con un sistema Asterisk, 
ya sea en su implementación o durante la so- 
lución de algún problema, conocer la estructu- 
ra de directorios que se arma en la instalación 
y el lugar donde se alojan los principales ar- 
chivos de configuración resulta de fundamen- 
tal importancia. La descripción que haremos a 
continuación no pretende ser exhaustiva, sino 
proporcionar una guía a la hora de buscar ar- 
chivos relacionados. 


e Los archivos de configuración, que emplea- 
remos y explicaremos en los capítulos si- 
guientes, se encuentran dentro del directorio 
/etc/asterisk, que será ampliamente utili- 
zado al trabajar con el sistema Asterisk. 

e En el directorio /var/lib/asterisk se 
alojan, entre otros, los archivos relaciona- 
dos con la funcionalidad de música en es- 
pera y los sonidos de señalización telefó- 
nica. Aquí también encontraremos la base 


de información de Asterisk y una serie de 
subdirectorios cuyos nombres refieren a las 
funciones relacionadas. Los archivos que se 
encuentran en estos subdirectorios suelen 
llamarse archivos de recursos. 

e En el directorio /var/spool/asterisk, en- 
tre otros archivos y subdirectorios, están los 
mensajes de voz, dentro de /var/spool/ 
asterisk/voicemail; y los archivos que 
permiten generar una llamada están den- 
tro de /var/spool/asterisk/outgoing. 
También encontraremos archivos temporarios 
en /var/spool/asterisk/temp. 

e El directorio /var/log/asterisk se em- 
plea para guardar toda clase de eventos del 
sistema y los registros de llamadas. El con- 
tenido de este directorio se utiliza frecuen- 
temente tanto en el diagnóstico y la solución 
de problemas, como en la auditoría y admi- 
nistración del sistema. 


Todos los módulos de software que hemos 
mencionado anteriormente se encuentran 
ubicados dentro del directorio /usr/lib/ 
asterisk/modules y se cargan por defecto 
al inicializar el sistema, a menos que se los 
deshabilite utilizando el archivo de configu- 
ración modules.conf. 





O QUEUE GAMES 





Cuando armamos un call center, en vez de utilizar música repetitiva para amenizar la 
espera de los clientes, una buena idea es usar Queue Games, un sistema de preguntas 


tipo trivia. Si el usuario es capaz de acertar, lo atenderán antes. 
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la instalacié 





Las versiones 
de Asterisk 


Sin entrar en detalles sobre los sucesivos cam- 
bios que ha sufrido la denominación de ver- 
sión en el mundo Asterisk y de los motivos que 
han llevado a esto, diremos que el identifica- 
dor de versión se compone de dos elementos: 
tronco y ramas. Por ejemplo, la versión 1.8 co- 
rresponde al tronco 1 rama 8. Dentro de cada 
rama tendremos las correcciones a los proble- 
mas funcionales encontrados y a cuestiones re- 
lacionadas con la seguridad. Por su parte, un 
cambio de tronco significa que se han introdu- 
cido modificaciones en la arquitectura y en las 
características. 


Nuestro consejo es que, en un ambiente de pro- 
ducción, vale más la estabilidad que disponer 
de nuevas características, tal vez ¡inestables y ra- 
ramente utilizadas. En la actualidad, se está mi- 
grando a un identificador de dos dígitos con un 
dígito de subversión. 


También existen dos clases de versiones: stan- 
dard y LTS (Long Term Support). La segunda 
es la que utilizaremos en este libro, dado que 





resulta la más estable. Si bien no posee las fun- 
cionalidades más sofisticadas, y menos pro- 
badas, la encontraremos en la mayoría de las 
implementaciones. 


Asterisk libera versiones nuevas cada año, al- 
ternando standard con LTS, y parches cada cua- 
tro meses. Las versiones que se encuentran en 
mantenimiento (aquellas con una vida supe- 
rior al año) solo reciben parches de seguridad 
y bajo demanda. Las que superan la marca de 
EOL (End Of Life) reciben asistencia durante un 
año más después de alcanzada la marca. 


Antes de la 
instalación 


Asterisk puede ejecutarse en una gran cantidad 
de plataformas Linux. Por lo general, los usuarios 
utilizan la que manejan o conocen mejor, pero lo 
cierto es que el sistema funcionará, la mayoría de 
las veces, en cualquiera de ellas. Sin embargo, de- 
bemos tener ciertos cuidados en la selección del 
kernel que vamos a usar, porque de la misma 
manera en que una mala selección del hardware 
ocasionará inconvenientes en las prestaciones 


¡MITO O REALIDAD? 





Muchos piensan que estar cerca de una torre de telefonía celular aumentaría el ries- 
go de padecer cáncer. Por esto, las empresas de telecomunicaciones idearon el uso de 
torres camufladas de árboles, postes, depósitos de agua o torres de iglesias. 
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== € AAA AR 





Dediop re Cl 


Get Ubuntu 


E A A A 
 ILCr Free to downliosd, 1 and shana 


Ubuntu Desktop > Ubuntu Server» 





del sistema, el kernel sobre el que vamos a montar 
Asterisk también puede hacerlo. Lo ideal es dispo- 
ner de un kernel lo más limpio posible, sin módulos 
de software, estéticos o de servicios que no se re- 
quieran. Además, debemos aclarar que, por su natu- 
raleza, Asterisk no se lleva bien con otras aplicacio- 
nes que se ejecuten en el mismo hardware y bajo la 
administración del mismo sistema operativo. 


Linux es el único sistema operativo soportado ofi- 
cialmente, y se aconseja el uso de la versión de 
kernel 2.6.25 o superior (aunque Asterisk corre so- 
bre kernels 2.4). Por lo general, se aconsejan al- 
gunas distribuciones de libre acceso que permiten 


_CURIOSIDADES CON ASTERISK 


Figura 4. En 

el sitio web 

de Ubuntu 
encontraremos 
gran variedad de 
información sobre 
la instalación. 


Cleuwd infrastrucbure + 


construir un sistema con solo lo necesario para 
proveer el contexto donde ejecutar Asterisk. Las 
distribuciones CentOS  (www.centos.org) y 
Ubuntu Server (www.ubuntu.com) son las pre- 
feridas a la hora de seleccionar la plataforma. Las 
instrucciones para instalar el software de platafor- 
ma pueden obtenerse de los sitios oficiales, no las 
veremos en este libro. 


En el desarrollo de nuestro trabajo emplearemos 
el sistema operativo Ubuntu, porque es uno de los 
más accesibles y conocidos. Entonces, los coman- 
dos y las instrucciones de instalación de Asterisk 
los daremos en el contexto de este sistema. 


¿Problemas de comunicaciones o energía? En un poblado de Uganda, se consiguió la comuni- 


cación gracias a una centralita de VolP, lo que permitió ahorrar caminatas de más de 30 kiló- 


metros. Eso sí, para hacerla funcionar, se necesita que alguien le dé al pedal. 
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El objetivo de esta obra es armar un sistema 
Asterisk básico desde cero, para obtener un 
producto apto para el aprendizaje y entrena- 
miento con esta tecnología. Dado que algunos 
lectores podrían encontrar difícil implementar 
esta propuesta, abordaremos el tema de los 
proyectos de sistemas abiertos sobre Asterisk, 
que intentan proporcionar una implementa- 
ción más sencilla y rápida, a través de paque- 
tes que incluyen todo lo necesario para armar 
un sistema Asterisk funcional. Aunque debe- 
mos saber que esto siempre conlleva el cos- 
to de la reducida flexibilidad y la desactualiza- 
ción de estos productos. 


PAQUETES REQUERIDOS 

Para realizar nuestra instalación, solo necesitamos 
el paquete Asterisk, y sugerimos tener los archi- 
vos de sonidos, como el asterisk-sounds, que 
puede encontrarse también como Core Sound y 
Extra Sound. 


Con respecto a los paquetes de la distribu- 
ción Linux elegida, tendremos que contar con 
los siguientes: 


e GCC (3.X) 
e ncurses-dev 





e libtermcap-dev 
CC. CFF 3.X 

e Tibtool (opcional pero recomendada) 
GNU make (versión 3.80 o mayor) 

e libcurl4-openssl-dev 


El código fuente de Asterisk puede descargarse 
del sitio oficial: www.asterisk.org. 


Instalación 
de Asterisk 


Cualquiera sea el sistema operativo que ha- 
yamos elegido, siempre debemos generar un 
usuario para realizar la instalación y ejecutar el 
sistema Asterisk que vamos a crear. Este detalle 
es necesario porque, para ejecutar la aplicación, 
tenemos que hacerlo bajo un usuario específi- 
co, que será su dueño. No es aconsejable que 
este Sea root, ya que para ejecutar los coman- 
dos de instalación es más seguro hacerlo des- 
de un usuario distinto. En nuestro caso, hemos 
creado el usuario denominado usuarioas- 
terisk. A continuación, veremos cómo reali- 
zar la instalación de la aplicación en diferentes 
procedimientos paso a paso. 


DIGITAL SIGNAL PROCESSOR 


El término ( 


) define un dispositivo integrado capaz de in- 


terpretar y modificar las señales de varias maneras. Este circuito realiza la 
del audio, lo que en general requiere un gran poder de cómputo. 
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PASO A PASO /1 


Preparar la plataforma 





Con el 5.0. instalado, realice 

su actualización y reinicie el 
sistema. Ingrese el siguiente 
comando en el prompt: + sudo 
apt-get update 48 sudo 
apt-get upgrade 48 sudo 
reboot. 


Una vez realizado el reboot, 
debe ingresar otra vez en el 
sistema con el usuario y la 
contraseña correspondientes. 


Instale el demonio de 
sincronización de tiempo 
(NTP) y actualice el tiempo 
del sistema: + sudo apt-get 
install ntp. 
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Resulta fundamental mantener la hora pre- 
cisa en un sistema Asterisk productivo. Como 
en otros casos de aplicaciones que brindan 
servicio, es indispensable contar con un re- 
gistro temporal cierto, tanto para el sincronis- 
mo entre los componentes del sistema, como 
para el registro de las llamadas, su dura- 
ción, los cargos por tiempo, las notificaciones 


PASO A PASO /2 


Configurar el demonio NTP 





de la casilla de mensajes de voz, etcétera. 
Debido al tratamiento que hace Ubuntu de este 
tema, por defecto, tendremos que reconfigurar- 
lo. Como es usual en Linux, esto significa editar 
y alterar uno o más archivos de configuración. 
El editor que trae incorporado Ubuntu se llama 
nano, y es el que emplearemos para hacerlo. A 
continuación, veremos cómo lograrlo. 
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En el prompt del S.O., ingrese el 
siguiente comando: dk sudo nano / 
etc/ntp.conf. 


El archivo ntp.conf controlará el 
comportamiento del demonio NTP. 


El contenido del archivo ntp.conf se 
mostrará en pantalla. Identifique la 
sección que contiene las siguientes líneas: 


i* By default, exchange time 


with everybody, but don't allow 
configuration. 


restrict -4 default kod notrap 
nomodify nopeer noquery 


restrict -6 default kod notrap 
nomodify nopeer noquery 
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PASO A PASO /2 (cont.) 





Para permitir que el demonio NTP se 
sincronice con una fuente externa, 
agregue a continuación las siguientes 
líneas: + By default, exchange 
time with everybody, but don't 
allow configuration. 


restrict -4 default kod notrap 
nomodify novpeer noquery 


restrict -6 default kod notrap 
nomodify nopeer 


noqueryrestrict -4 127.0.0.1 


En pantalla deberá ver lo que se 
que muestra a continuación: dk By 
default, exchange time with 
everybody, but don't allow 
configuration. 


restrict -4 default kod notrap 
nomodify novpeer noquery 





restrict -6 default kod notrap 
nomodify nopeer 


noqueryrestrict -4 127.0.0.1 


restrict -6 ::1 
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Para salir del editor, presionamos la combina- el editor: /etc/ntp.conf. A continuación, 
ción de teclas CTRL + X y, luego, pulsamos Y debemos reiniciar el demonio para que tome 
para guardar las modificaciones. 


los cambios efectuados. Esto se hace con el 
siguiente comando: 
Es importante saber que no debemos cambiar el 


nombre del archivo sino aceptar el sugerido por 


sudo /etc/init.d/ntp restart 


PASO A PASO /3 








Instalación de las dependencias de software 


Ingrese el siguiente comando en el prompt del S.O.: 
1 sudo apt-get install build-essential 
subversion A 
libncurses5-dev libssl-dev 1ibxml12-dev. 

A continuación, se desplegará la instalación de 


tres librerías. 


Cree la estructura de directorios: 


iFmkdir -p -/src/sistema-asterisk/ 
asterisk. En este directorio se almacenará la 
fuente de Asterisk para su posterior instalación. 


Vaya al directorio creado: 





iF cd -/src/sistema-asterisk/asterisk 
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.8/menuselect/mxml/Makefile.in 
.8/menuselect/mxml1/mxml.pc.in 
.8/menuselect/mxml/configure.in 
.8/menuselect/mxml/mxml-set.c 
.8/menuselect/mxml/ANNOUNCEMENT 
.8/menuselect/mxml1/mxml.list.in 
.8/menuselect/mxmly/README 
.8/menuselect/mxml/config.h.in 
.8/menuselect/mxml/mxml-search.c 
.8/menuselect/mxm1/mxml-string.c 
.8/menuselect/mxml/mxml.h 
.8/menuselect/mxml1/mxml-index.c 
.8/menuselect/mxml/mxml-attr.c 
.8/menuselect/mxm1/mxml-private.c 
.8/menuselect/mxml1/mxml-entity.c 
.8/menuselect/mxm1/COPY ING 
.8/menuselect/mxml/CHÁANGES 
.8/menuselect/mxml1/mxml1-file.c 
.8/menuselect/mxml/install-sh 

U 1.8/menuselect/mxml 

Checked out external at revision 430. 


ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 
ñ 


fo po po fo fo plo po fo plo po foo fo flo fo fo fo fo fo pa 


Checked out revision 1110. 
Checked out revision 382006. 


Figura 5. Pantalla 
final, después 

de una descarga 
exitosa del 
software Asterisk; 
en este caso, la 
versión 1.8. 


usuarioasteriskGubuntu:”“/src/sistema-asterisk/asterisk$9 _ 


Ahora tenemos que instalar las dependencias 
de software requeridas por Asterisk. 


En este directorio descargaremos el código del 
software Asterisk, para desde él iniciar las instala- 
ciones correspondientes. Este tema lo veremos en 
el siguiente apartado. 


DESCARGAR EL CÓDIGO DE ASTERISK 

En el mundo Linux, en general, siempre hay va- 
rlas maneras para obtener el código de una aplica- 
ción. La más popular entre los usuarios es a través 
del Centro de software, en el caso de un desktop; 
o bien su versión CLI (Command Line Interface), 
mediante el comando apt-get. En este caso, las 
versiones se obtienen de repositorios reconocidos 
por la comunidad Linux, pero que pueden estar 
algo desactualizados en comparación con las ver- 
siones estables que utiliza la comunidad Asterisk. 


Un método que permite obtener el código ori- 
ginal es el denominado subversion. Para esto, 
debemos ingresar el siguiente comando en el 
prompt del sistema operativo: 
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F svn co http://svn.asterisk.org/svn/ 
asterisk/branches/1.8. 


En cambio, para hacer la descarga alternativa 
de una versión específica tenemos que ingresar: 


iF svn co http://svn.asterisk.org/svn/ 
asterisk/branches/1.8.X 


INSTALAR EL SOFTWARE DIGIUM 
ASTERISK HARDWARE 

INTERFACE (DAHDI) 

Digium Asterisk Hardware Interface (DAHDI) 
es un software que se requiere como interfaz 
del sistema operativo y el hardware de telefo- 
nía. Si bien en este trabajo no abordaremos la 
interconexión con el mundo exterior a través 
de hardware específico, este software contiene 
ciertas dependencias que pueden ser requeri- 
das por algunas funciones de Asterisk que sí 
podríamos necesitar. 


Es importante que la versión del kernel en uso 
coincida con la del código fuente del kernel 


RedUSERS: 








instalado. Para verificar la versión del kernel que 


Como el software DAHDI se actualiza con fre- 
se está ejecutando, usamos el siguiente comando: cuencia, para tener la última versión, debemos 
consultar el sitio http://donwloads.asterisk. 
sudo apt-get install linux-headers- org e ingresar los identificadores correspondien- 
“uname -r'. tes, que aquí indicamos como id-version. 
PASO A PASO /4 





Instalación del software DAHDI 





Cree el directorio DAHDI en Asterisk: 
IF cd .. 


dE mkdir dahdi 


Descargue el software en el directorio 
creado: dk cd dahdi/ 


df svn co http://svn.asterisk. 
org/svn/dahdi/linux-complete/ 
tags/ “id-version-dhadi_ 





linux+id-version-dhadi_tools” 
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PASO A PASO /4 (cont.) 





Cambie al directorio /”id-version- 
dhadi_linux+id-version-dhadi_ 
tools”: 


dF cd “id-version-dhadi_ 
Tinux+id-version-dhadi_tools” 


IF svn co http://svn.asterisk. 
org/svn/dahdi/linux-complete/ 


tags/ “id-version-dhadi_ 
Tinux+id-version-dhadi_tools” 


Instale y configure el software: 
1 make 


iF sudo make install 


iF sudo make config 





Es importante señalar que el identifica- Si volvemos al paso a paso anterior, podemos 
dor de versión de DAHDI está compuesto observar que esto lo hemos indicado de la si- 
de dos partes, porque el software contie- guiente manera: 


ne tanto los drivers del sistema Linux, como 
las herramientas de configuración y gestión “id-version-dhadi_linux+id-version- 
correspondientes. dhadi_tool1s”. 
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PASO A PASO /5 
Instalar el software Asterisk y los accesorios 


«uirrbin-inslall bh 644 nodo lez sample +cle-dahd ¿modo les 
muta lll - =D enconT_parapelers «elc-dahd i«gencón!_paramele 


b 64 nodprobe. conf .zanple «cLbe-modprobe.d-dabdi.conf 
b -—-. 614 blacklizt.szanple «etc-modprobe.drdabdl. .blacklist.:x 


1 e a 
, ES dabhdi 2 ¿"dell drdabd il 
DAHBI has been configured. 


Lizt al detected DAHDI druicrz 


Ha bardeare Found 
y directory *-«honesusuarloasterlskesrosrs lstena-asterlsk-dabdis2.b 


Ma “esrcra icatena=acterick-dahdisZ.6.112.6.19 cd “rerecraleten 
rasteriskr1,B0 
asuaricistor lick bunto 2" src 3 listen az ber lskrasterizkr1.86% _ 





Cambie el directorio donde se descargó el código Asterisk: + cd -/src/sistema-asterisk 
asterisk/1.8. Instale el software descargado, mediante los siguientes comandos: 

dE ./configure 

1 make 

iF sudo make install 

iF sudo make config 


isuarivasteriskbubunta 
ñádding systen x 
eta co 


et 5.4504 


Le eS 
marivoaster is kbubunt 


a 
k 
k 
k 
k 
5h 
k 
k 
k 

sa 





Instale la utilidad Menuselect: + cd -/src/sistema-asterisk/asterisk/1.8/ 
ik make menuselect 
i* sudo make install 
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PASO A PASO /5 (cont.) 


A IA A AA AA 


terizk ha successfully been installed 
u uould like to install the 
tion files overuriting any 





Modifique los permisos en los directorios de instalación: 

IF sudo chown -R usuarioasterisk:usuarioasterisk /usr/1ib/ 
asterisk/ 

iF sudo chown -R usuarioasterisk:usuarioasterisk /var/lib/ 
asterisk/ 

IF sudo chown -R usuarioasterisk:usuarioasterisk /var/spool/ 
asterisk/ 

IF sudo chown -R usuarioasterisk:usuarioasterisk /var/log/ 
asterisk/ 

IF sudo chown -R usuarioasterisk:usuarioasterisk /var/run/ 
asterisk/ 

IF sudo chown usuarioasterisk:usuarioasterisk /usr/sbin/ 


asterisk 


Si no existe, cree el directorio /etc/asterisk: 

IF sudo mkdir -p /etc/asterisk 

IF sudo chown usuarioasterisk:usuarioasterisk /etc/asterisk 
TF cd /etc/asterisk/ 
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PASO A PASO /5 (cont.) 


make pr 


Lirez that 
your 1 


zlena-arzlLeri be -B5 Ghaamn MET] 
lib-arteris 
náa-arterl a sudo choun EAT Al 
sasteriszk 
15 sudo choun E usuari 
"asterlsk-"1.05 5 chown - 
¡ksasterisk-1.63 sudo chown 
BS sudo chowumn u 
ckraslerisk-1.85 sudo akdir 


ESTE A AS EE AT ES 


EA A A a a A 
MAA A 





Copie el archivo indications.conf.sample: 
IF cp -/src/sistema-asterisk/asterisk/1.8/configs/indications.conf.sample M 
./indications.conf 


mar ioaster 
rioasterl: n arsterisk 
asterl 


arivasterizk 
arivast 
ariossterick 
arivaslerisktub 
arivas ter ik 
sberizk 


arios ber ik 
ivasteriskrub 


MATAN 
ad MATAN 
arÍniaster MATA el 
arios ber MATAN E "1ER + proa lmteñna -aptberizk-rasterisk.1.B5.«con 
"mid icat dr conf ple >» loans. cont 
ant ios ter izkRruburnta:. 





Copie el archivo asterisk.conf.sample: 
IF cp -/src/sistema-asterisk/asterisk/1.8/configs/asterisk.conf.sample Y 
/etc/asterisk/asterisk.conf 





27 


» 1. Introducción e instalación de Asterisk === 





PASO A PASO /5 (cont.) 





Durante la instalación del S.0., creó un usuario distinto de root; ese usuario es el que debe 
emplear para llevar a cabo la instalación. Cree el archivo modules.conf: 
IF cat >> /etc/asterisk/modules.conf 


Aquí podrá habilitar la carga de los módulos de software automáticamente (los que se 
encuentren en el directorio correspondiente) y deshabilitar los que sean innecesarios para la 
instalación. Configure los parámetros básicos de musiconho1d.conf: 

df cat >> musiconhold.conf 

; musiconhold.conf 

[default] 

mode=files 

directory=moh 

Ctrl + D 


Para finalizar con el procedimiento, deberemos guar- que siguen, avanzaremos con la configuración de 
dar todos los cambios introducidos. En los capítulos cada uno de los archivos que hemos instalado. 


O RESUMEN 


En el presente capítulo, hemos visto la estructura de Asterisk, el versionado y cómo dimen- 
sionar una plataforma, para luego instalar el programa y los accesorios de software ne- 





cesarios para componer un sistema básico, que configuraremos en capítulos posteriores. 
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Capítulo 2 


Configuración 
de Asterisk 








€») Configuración de Asterisk 





Configurar archivos 
de muestra 


Si cumplimos con éxito las tareas del capítulo 
anterior, en este punto deberíamos de tener 
un sistema Asterisk funcionando, pero sin que 
pueda prestar servicio alguno, pues nos falta 


PASO A PASO /1 


Generar archivos de muestra 


realizar su configuración. Para esto, y como 
sucede en general con las aplicaciones Linux, 
deberemos editar archivos de configuración y 
completarlos con ciertos datos, que le darán 
forma al sistema bajo implementación. Para 
comenzar a familiarizarnos con ellos, vamos 
a generar los archivos de muestra que vienen 
con el sistema. 
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Vaya al directorio donde descargó 
Asterisk: 


dE cd -/src/sistema-asterisk/ 


asterisk/1.8. (1.8. es la 
versión descargada). 


Genere los archivos de muestra: 


iF* sudo make samples 
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Configurar archi 





Esto creará en el directorio /etc/asterisk 
los archivos de configuración que podremos 
emplear como referencia para nuestras propias 
configuraciones. Una vez creados, sugerimos 
que los explore, para tratar de familiarizarse con 
la nomenclatura y los formatos de las directivas 
empleadas. 


A continuación, pasaremos a mover estos 
archivos a un directorio de reserva, que deberá 
ser creado para alojar los archivos originales, 
con el propósito de tenerlos para futuras 
referencias. Denominaremos a este directorio 
/etc/asterisk/samples. 


Debemos ser cuidadosos al correr el 
comando make samples en un sistema 
Asterisk productivo, puesto que sobrescribirá 
los archivos de configuración existentes y 
desarmará, literalmente, nuestro sistema de 


PASO A PASO /2 


Copiar los archivos de muestra 
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telefonía. Si esto sucede, deberemos recurrir a 
las copias de respaldo para restituir los archivos 
reemplazados por el comando y, así, recuperar 
la funcionalidad de la central telefónica Asterisk. 


Resultará beneficioso y pedagógico crear 
desde cero los archivos de configuración que 
se requerirán. Esto permitirá tener una mejor 
comprensión del funcionamiento del sistema 
y, además, nos permitirá concentrarnos en los 
archivos que realmente necesita el sistema 
básico, y no distraernos con la gran cantidad 
de información y archivos que implica la 
configuración completa de Asterisk. 


En principio, podemos utilizar los archivos in- 
dications.conf y asterisk.conf creados 
en el directorio fuente de Asterisk, copiándo- 
los a /etc/asterisk. Veamos el siguiente 
procedimiento. 





Cambie los permisos del directorio 
para el usuario administrador 

creado: ¿sudo chown 
usuarioasterisk:usuarioasterisk 
/etc/asterisk 


iF'sudo chown 


usuarioasterisk:usuarioasterisk 
/dev/dahdi/transcode 
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PASO A PASO /2 (cont.) 
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Copie el archivo indications.conf, 
creado en el paso a paso anterior, 

al directorio de configuraciones 

de Asterisk: cp -/src/sistema- 
asterisk/asterisk/1.8/configs/ 
indications.conf.sample Y/etc/ 
asterisk/indications.conf 


Copie el archivo asterisk.conf, 
creado en el paso a paso anterior, 

al directorio de configuraciones 

de Asterisk: cp -/src/sistema- 
asterisk/asterisk/1.8/configs/ 
asterisk.conf.sample: 


Wetc/asterisk/asterisk.conf 
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Edite el archivo asterisk. 
conf, busque la sección 
[options] y modifique los tem: 


runuser=usuarioasterisk 


rungroup=usuarioasterisk 


Al guardar el archivo resultante, estará 
en condiciones de ejecutar Asterisk en 
una configuración mínima, con la que 
poco podrá hacer, pero será el punto de 


partida. Emplee para esto el comando: 
/usr/sbin/asterisk -c 
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Mientras Asterisk se inicia, veremos diferen- 
tes mensajes en pantalla. Al terminar el pro- 
ceso, obtendremos una interfaz en modo lí- 
nea de comando o CLI. Este comando inicia 
Asterisk en modo de ejecución de primer pla- 
no. Aquí podremos jugar con algunos coman- 
dos del programa, solo para verificar su funcio- 
nalidad; por ejemplo, revisar el estado de los 
módulos con el comando CLl module show o 
detener la ejecución del módulo con el coman- 
do core stop now. 


Configurar 
los archivos 
del sistema 


Como mencionamos en el Capítulo 1, los archivos 
de configuración fundamentales para contar 
con un sistema Asterisk operativo son los que 
detallamos a continuación: 


e asterisk.conf 

e modules.conf 

e musiconhold.conf 
e indications.conf 


DD) CENTRALES TELEFÓNICAS 


A continuación, describiremos cada uno de 
ellos en detalle y veremos su configuración. 


ARCHIVO ASTERISK.CONF 

Este archivo está compuesto por numerosas 
secciones. Algunas de ellas ya las vimos y, en 
general, diremos que se trata del archivo de 
configuración que gobierna el funcionamiento 
de la aplicación Asterisk como tal. Comúnmente, 
podremos utilizar el archivo de muestra que viene 
con el sistema, haciéndole los cambios sugeridos. 
Es más, podremos ejecutar Asterisk sin él, pero 
algunas de sus opciones nos resultarán muy útiles, 
y otras, necesarias. 


En este archivo se indican los directorios de la es- 
tructura de Asterisk y su función, aunque es po- 
sible cambiar los predefinidos si fuera necesario. 
También se pueden parametrizar opciones de acce- 
so remoto y compatibilidad entre versiones. Como 
con cualquier aplicación UNIX, podremos recurrir al 
comando man asterisk para revisar con detalle 
lo que estemos buscando. 


En esta instancia, vamos a crear los archivos 
modules.conf y musiconhold.conf, y a 
configurar lo mínimo indispensable para iniciar 
nuestro sistema de manera funcional. 





Son dispositivos que realizan en forma automática el trabajo que, en los albores de la te- 
lefonía, efectuaban las telefonistas. En sus inicios, fueron grandes equipos electromecá- 


nicos, que evolucionaron a equipos basados en circuitos integrados a gran escala. 





34 


RedUSERS: 





> Configurar los arch 








ARCHIVO MODULES.CONF noload 
El archivo modules.conf debe ser creado me- 
diante el editor preferido en el directorio /etc/ noload 
asterisk. Este archivo se emplea para definir qué 
módulos deben ser cargados por Asterisk al iniciar noload 
el sistema y cuáles no. Por defecto, con el paráme- 


> chan_0ss.so 


ll 
NS 


chan_mgcp.so 


ll 
NS 


chan_skinny.so 


tro autoload=yes, Asterisk cargará todos los mó- noload => chan_phone.so 
dulos que se encuentran en el directorio /usr/ 

lib/asterisk/modules. noload => chan_agent.so 
[modules] noload => chan_unistim.so 
autoload=yes noload => chan_alsa.so 


Ahora, en el mismo archivo debemos desactivar los 
módulos innecesarios: 


; Application modules 


noload => app_nbscat.so 
; Resource modules 


noload => app_amd.so 
noload => res_speech.so 

noload => app_minivm.so 
noload => res_phoneprov.so 

noload => app_zapateller.so 
noload => res_ael_share.so 

noload => app_ices.so 
noload => res_clialiases.so 

noload => app_sendtext.so 
noload => res_adsi.so 

noload => app_speech_utils.so 
; PBX modules 

noload => app_mp3.so 
noload => pbx_ael.so 

noload => app_flash.so 


noload => pbx_dundi.so 


noload => app_getcpeid.so 


: Channel modules 
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noload => app_setcallerid.so noload => app_test.so 

noload => app_adsiprog.so noload => app_externalivr.so 

noload => app_forkcdr.so noload => app_image.so 

noload => app_sms.so noload => app_dictate.so 

noload => app_morsecode.so noload => app_festival.so 

noload => app_followme.so Si queremos observar qué sucede ahora con el 
sistema que estamos implementando, podemos 

noload => app_url.so iniciar Asterisk otra vez, como se indica en el punto 
5 del Paso a Paso Copiar los archivos de 

noload => app_alarmreceiver.so muestra, y observar qué módulos están cargados. 

noload => app_disa.so Ingresamos en el sistema con el usuario crea- 
do para administrar Asterisk (en nuestro ejemplo, 

noload => app_dahdiras.so usuarioasterisk) y escribimos los comandos: 

noload => app_senddtmf.so lk asterisk -c 

noload => app_sayunixtime.so CLI> module show 


format_g719.so ITU 6.719 
app_meetme.so MeetMe conference bridge 


cel_custom.so Customizable Comma Separated Values CEL 


func_extstate.so Gets an extension's state in the dialpla 


app_dumpchan.so Dump Info About The Calling Channel 
res_convert.so File format conversion CLI command 
func_sysinfo.so System information related functions 


func_volume.so Technology independent volume control : 
Figura 1. Algunos 
chan_local.so Local Proxy Channel (Note: used internal > 

de los módulos 


func_audiohookinherit.so ñudiohook inheritance function 


funcionales 
app_directed_pickup.so Directed Call Pickup Application 


147 modules loaded cargados en el 


“CLIS 





sistema Asterisk. 
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Veremos los módulos que han sido cargados, 
interpretando nuestras instrucciones dadas a través 
del archivo modules.conf. 


ARCHIVO MUSICONHOLD.CONF 

Todo sistema telefónico posee una serie de soni- 
dos para indicar ciertas señales, como el tono de 
llamada entrante, el tono de ocupado o la músi- 
ca en espera. Estos sonidos deberán ser instalados 
de alguna manera en el sistema para que Asterisk 
pueda utilizarlos cuando sea necesario. El archivo 
musiconhold.conf define las clases para los so- 
nidos de la música en espera, empleados en varias 
situaciones durante el flujo de una llamada. Para 
comenzar, debemos crear un archivo en /etc/as- 
terisk, llamarlo musiconho1d.conf y comple- 
tarlo con las siguientes líneas: 


; Clase por defecto 


PASO A PASO /3 


Instalación de Menuselect 


[default] 
mode=files 
directory=moh 


Los sonidos reales, digitalizados y codificados se 
deben instalar mediante la utilidad Menuselect 
de Asterisk. Esta se emplea para una gran cantidad 
de situaciones, desde el apoyo para el diagnóstico 
de problemas, hasta la instalación de paquetes 
definidos, como los sonidos en varias codificaciones 
y formatos. En general, se la utiliza para configurar 
qué módulos compilar e instalar; es decir, es otra 
manera de armar el sistema Asterisk. 


La utilidad Menuselect debe ser instalada en 
nuestro sistema. Veremos cómo hacerlo en el si- 
guiente Paso a Paso. 
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Instale la librería 1ibnewt necesaria 
para habilitar la nueva presentación de la 
interfaz de Menuselect: 


iF sudo apt-get install 
libnewt-dev 


Sl 
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Vaya al directorio en que descargó 








2 coc Asterisk: ¿+ cd -/src/sistema- 
ET Pi pa == asterisk/asterisk/1.8.x, e instale 
pie la utilidad: 

Confileka la: iF cd menuselect 
—= if make clean 

iF ./configure 

cd .. 

if make menuselect 

Se presentará una interfaz 

3 Pa deso 1 Cone Sounas. E uno en dos colores, que podrá 
e 2 : : navegar con las teclas de 
pit -soumDs Em dirección. Vaya a Core Sound 
OS Packages y presione la tecla 
A asar FLECHA DERECHA O ENTER 

para desplegar el submenú de 
opciones disponibles. 

4 Seleccione CORE-SOUNDS-EN- 


incoarca Rodo lor -- aumzprcifiad --- t 
Tnxt Modo lnz [=3 EXTRA-S0UNDS- EM -UñU |] 
Compiler Flagu [1 EXTEA-SO0UADE- Er 0 
Voices il Build Optionz 
iiilindes 

4 


WAV, vuelva a las opciones 
con FLECHA IZO. y seleccione 


ña! Samples 
fodale Esbeddlog 
Core Beas Packs 


ges 
Aus lo Os Hold File NES 


Esglich, a-Lau Format 


Eoaf licta wlthi E 
Juppert Lesel; aripecióicd 


Extra Sound Packages. 
Aquí conviene seleccionar los 
sonidos en formato WAV 

y ALAW.. 
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Es importante destacar que el tipo de forma- 
to de los archivos de sonido tendrá un impacto 


Una vez terminado el proceso de selección, in- 


gresamos X para guardar y salir de la utilidad. 
importante en el rendimiento del procesador al 


momento de su uso. Siempre debemos utilizar 
un formato compatible. 


Ahora solo nos queda instalar los paquetes de 
sonido. Para hacerlo, es necesario que el ser- 
vidor tenga una conexión operativa a Internet. 


PASO A PASO /4 
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Instalación de los paquetes de sonido 


Instale los paquetes seleccionados con 
Menuselect: 


iF sudo make install. 


Cambie los permisos del directorio para 
el usuario creado: 


i* sudo chown -R 


usuarioasterisk:usuarioasterisk 
/var/lib/asterisk/sounds/. 
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Música en espera: derechos de autor 
Otro aspecto importante que debemos tener en 
cuenta con respecto a los sonidos es el legal. 
No es posible utilizar cualquier tema musical, ya 
sea descargado de Internet o tomado de un CD, 
adquirido o no, dado que la licencia que lo pro- 
tege no permite su uso comercial, salvo pago de 
un canon que determina el dueño de los dere- 
chos del tema en cuestión. Este puede ser el au- 
tor, una sociedad de autores o algún particular 
o empresa que los haya adquirido legalmente. 
En caso de emplearlo sin abonar este canon, se 
estará infringiendo los derechos de autor y será 
aplicable la penalización que contemple la ley 
para ese caso. Por eso, es necesario revisar los 
derechos que protegen a los autores de la mú- 
sica que queremos utilizar o crear nuestros pro- 
pios temas musicales. 


Si localizamos temas con licencias tipo CC, ten- 
dremos que resolver el asunto del formato. Por 
lo mencionado anteriormente, el formato ¡deal 
es WAV, pero el más popular es MP3, así que 
tendremos que realizar una conversión de for- 
matos antes de instalar el archivo en el sistema. 


DD) RESUMEN 


ARCHIVO INDICATION.CONF 

Por último, el archivo indications.conf es, 
desde el punto de vista operativo, el más inte- 
resante, porque en él se definen los sonidos de 
señalización telefónica, asociándolos a los ca- 
nales que se configuren en el sistema. Esto se 
realizará aplicando un tonezone a los canales, 
como parte de su configuración. 


Así quedarán determinados el conjunto de soni- 
dos por utilizar según la región o el país para el 
que estemos configurando el sistema. La línea a 
continuación muestra esta asignación: 


Set(CHANNEL(tonezone)=[código_de_ 
país) ; 


El código de país coincidirá con el identificador 
que se ubica en los dominios DNS. Podemos 
modificar el archivo de muestra que viene insta- 
lado con Asterisk. Lo copiamos desde el direc- 
torio /usr/src/sistema-asterisk/1.8/ 
configs/indications.conf.sample y, en 
la copia, modificamos el parámetro country 
en la sección [general]. 





En este capítulo creamos y configuramos los cuatro archivos básicos del sistema. 
Instalamos los grupos de sonidos empleados en la señalización y en el servicio de 
música en espera, y la utilidad Menuselect, empleada para definir los componentes 


del sistema Asterisk. 
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Canales 
y dispositivos 


Antes de comenzar con los detalles de la con- 
figuración de canales y dispositivos, debemos 
hacer una aclaración. Si bien Asterisk permi- 
te la interconexión de teléfonos analógicos, 
siempre que contemos con el hardware corres- 
pondiente, en este capítulo solo vamos a tra- 
tar la conexión de dispositivos IP, en particular, 
los denominados softphones. Ahora sí, entra- 
remos en nuestro tema. 


Los canales son una abstracción empleada por 
Asterisk para definir parámetros relacionados 
con los dispositivos que se conectan a él. 
Estos se implementan mediante archivos 
de configuración, donde se inscriben los 
parámetros correspondientes a los dispositivos 
telefónicos, ya sean teléfonos o troncales 
de interconexión entre centrales telefónicas 
públicas o privadas. En tanto, los dispositivos 
son los aparatos o el software telefónico que 
empleamos para realizar llamadas. 


Asterisk se puede conectar con distintos tipos de 
interfaces y dispositivos, como: 


O PUERTOS FXO Y FXS 


e Circuitos digitales, como troncales El. 

e Protocolos de voz sobre IP, como SIP. 

e Interfaces analógicas, como teléfonos analógicos 
o líneas telefónicas. 

e Teléfonos IP físicos y softphones. 


La conexión se realiza a través de hardware 
que, a diferencia de los productos propietarios, 
es de tipo estándar y de bajo costo. En nues- 
tro caso, solo emplearemos la conexión de red 
como interfaz para realizar la interconexión de 
dispositivos, dado que, como dijimos, solo nos 
ocuparemos de dispositivos IP. No obstante, 
mostraremos cómo configurar una interfaz que 
nos permita conectarnos a una línea telefónica 
convencional, con el propósito de realizar lla- 
madas al exterior de la central Asterisk. 


La configuración de los canales es un procedimien- 
to relativamente sencillo y directo, pero también 
será necesario configurar los dispositivos telefóni- 
cos involucrados en las llamadas. La configuración 
se separa en dos grandes etapas: 


e Configurar Asterisk con los parámetros del 
dispositivo. 

e Configurar el dispositivo con los parámetros de 
Asterisk. 





RESMHESS (0/9) SETAS EE IEEE EAS ER TACA 
una central telefónica. Un puerto FXO no genera tono de invitación a discar pero acepta 


uno, y uno FXS genera tono de invitación a discar sin aceptarlo en retorno. 
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Estas actividades se realizan sobre archivos de 
configuración; en el caso de Asterisk, sobre el ar- 
chivo de configuración del canal utilizado por el 
dispositivo. En el caso del dispositivo, se trata de 
un archivo que se encuentra dentro de la estruc- 
tura de software del mismo aparato o softphone. 


Protocolo SIP 


SIP (Session Initiation Protocol) es un protoco- 
lo de señalización telefónica utilizado en teléfonos 
VolP, tanto físicos como software. Consiste en un 
protocolo peer-to-peer empleado para el estable- 
cimiento de las llamadas, las maniobras durante 
ellas (por ejemplo, transferencia) y su finalización 
en redes de telefonía IP. Este no trata con la in- 
formación de voz de la llamada, los tonos de in- 
vitación de la central o la música en espera, por- 
que de su transporte se encarga el protocolo RTP 
(Real Time Protocol), descripto en la RFC 3550. 
La definición peer-to-peer implica que un telé- 
fono SIP necesita hacer una conexión directa con 
otro teléfono SIP, sin que una PBX se encuentre 
en el medio. Sin embargo, Asterisk no cumple con 
esta norma. Cuando una llamada se realiza entre 
dos terminales SIP a través de una central Asterisk, 
esta se encontrará en medio de la comunicación. 


O MÁS INFORMACIÓN SOBRE SIP 


El protocolo SIP está descripto en la 


Habrá dos llamadas: una entre la terminal llaman- 
te y Asterisk, y otra, entre Asterisk y la terminal lla- 
mada. La central conmutará la llamada, realizan- 
do un bridge de los dos canales involucrados. Los 
extremos de la comunicación SIP, denominados 
agentes de usuario, pueden ser cliente o servi- 
dor. El cliente es el que generará la llamada, en 
tanto que el servidor será el encargado de proce- 
sarla y producir una respuesta. Por ejemplo, cuan- 
do un teléfono IP hace una llamada a un softpho- 
ne, genera un requerimiento y lo envía a un proxy 
SIP. Este se hace cargo del requerimiento, analiza 
el destino y lo conmuta hacia él. Una vez que los 
dos agentes han negociado con éxito el estableci- 
miento de la llamada, la voz es transportada a tra- 
vés de RTP y enviada directamente entre los dos 
agentes. El proxy no se ocupa de los datos de voz, 
solo habla SIP. 


Con respecto a su comportamiento en un en- 
torno SIP Asterisk se define como un agente de 
usuario back-to-back (B2BUA), dado que actúa 
como un agente de usuario SIP tanto en la recep- 
ción como en el reenvío de la llamada a otro ex- 
tremo. Cuando el teléfono IP llama a un núme- 
ro de extensión, la llamada se establece entre él y 
Asterisk. Si la programación de Asterisk indica que 
hay que llamar a otro agente, este actúa otra vez 


. Para profundizar la información sobre 


él, sería importante leer al menos las primeras 80 páginas de esta recomendación, 
que es una introducción. Podemos encontrar la RFC en 
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Teléfono Sip 
A 


Registro + autenticado 
ok 200 


Registro 


. . .. . 


Requerimiento: invitación Sip 
Estado: Intentando 100 


Inicio de 
llamada 


Códigos e 
Sip Estado: Ringing 180 


ASTERISK 


Teléfono Sip 
B 


Registro + autenticado 


Requerimienteo: invitación Sip 
Estado: Intentando 100 


Estado: Ringing 180 


Estado: 200 ok + descripción de sesión 
Requerimiento: ACK (reconocido) Sip 


Estado: 200 ok + descripción de sesión 
Requerimiento: ACK (reconocido) Sip 


Conversación: audio RTP/RTCP entre extremos A y B | 


Req: BYE (adios) Sip - corta llamada 
Estado: 200 OK 


Bye Sip: Requerimiento de corte 


Estado: 200 OK 


Fin de llamada a requerimiento del extremo B 





Figura 1. En el esquema se observa el diagrama de estados del protocolo. 


como agente de usuario y establece otra conexión 
(canal) al softphone. Los datos irán directamente a 
través de Asterisk, así es que ambos terminales es- 
tán hablando directamente con él. 


Tendremos que configurar el dispositivo SIP para 
que envíe las llamadas a la central Asterisk, aun 
si este puede realizar y mantener la llamada 
directamente contra la terminal contraparte. 
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Infraestructura 
requerida 


En instalaciones donde se empleen aparatos te- 
lefónicos IP conectados a la red, será de gran 
utilidad contar con una serie de servicios de red 
que harán que la puesta en servicio y el mante- 
nimiento de los aparatos sean más simples. Los 
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servicios que se encargan de realizar estas fun- 
ciones son DHCP y FTP/TFTP. 


Por lo general, la configuración de los teléfo- 
nos |P puede ser muy compleja, hecho que se 
ve agravado por las interfaces empleadas, que 
distan de ser intuitivas. Además, la configura- 
ción depende del fabricante y suele ser propie- 
taria. Así, si utilizamos varias marcas de teléfo- 
nos IP (algo que podemos hacer, dado que en 
este ambiente podemos alcanzar un alto grado 
de compatibilidad), deberemos desarrollar una 
estrategia distinta para cada una. Por todo esto, 
para simplificar la configuración de los teléfo- 
nos IP, es conveniente desarrollar una estrategia 
de autoconfiguración, para lo cual se requieren 
los dos servicios, cuyo funcionamiento explica- 
remos a continuación. 


Los teléfonos IP vienen con una configuración 
por defecto que permite obtener su dirección 
IP de manera automática mediante el protoco- 
lo DHCP. Entonces, cuando conectamos un te- 
léfono de este tipo a la red (como si se tratara 
de una PC), este comienza a requerir atención 
de un servicio DHCP para obtener su dirección. 
Una vez lograda, el teléfono se dispone a buscar 
el archivo de configuración y las actualizaciones 


O TRANSMISIÓN Y CONMUTACIÓN 


El área de la telefonía se separa en dos grandes sectores: la 






de software en el servidor de archivos provisto 
por el servicio junto con la dirección IP y otros 
parámetros, como la puerta de enlace. Esta 
transferencia se realiza mediante el protocolo 
TFTP o FTP, según lo requiera el aparato. 


De este modo, lo único que debemos hacer para 
asignarle un teléfono a un usuario es conectarlo 
en un puerto de red habilitado para tal efecto, 
como hacemos con una computadora. Su lógica 
interna y los servicios descriptos harán el resto. 


Escapa al alcance de este libro analizar los por- 
menores de la instalación de los servicios, y di- 
remos que no son necesarios en lo que a la tele- 
fonía atañe. En el caso de emplear un softphone 


en una computadora, este se configurará desde 
su propia interfaz. 


Configuración 
básica de Asterisk 
para un teléfono SIP 


Los teléfonos SIP y el sistema Asterisk 
tienen una gran cantidad de opciones de 


y la 


. Asterisk está ubicado en el sector de conmutación, en tanto que habrá 
aspectos de transmisión asociados con el hardware que conectemos en el servidor. 
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configuración, que pueden generar cierta 
confusión al momento de poner un aparato 
en servicio. Sin embargo, Asterisk no requiere 
demasiado para conectarse con un teléfono 
SIP. Como primera tarea, lo que debemos 


hacer es configurar un canal SIP mediante 
la manipulación del archivo sip.conf. A 
continuación, en el Paso a Paso 1, explicamos 
cómo poner rápidamente en servicio un 
aparato telefónico IP. 


PASO A PASO /1 


Configuración básica de un canal SIP 








Copie el archivo de configuración de 
muestra: dF mv sip.conf sip.conf. 
sample 


df touch sip.conf 





A A Edite el nuevo archivo sip.conf 
see y complételo con estos datos: 

[general] 

[telefonoSIP] 

type=friend 

context=grupoSIP 





host=dynamic 
secret=unaclave 
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Antes de continuar, tenemos que hacer algunas 
aclaraciones sobre las denominaciones usadas 
en este sistema. Para identificar el teléfono con 
un nombre, podemos utilizar cualquier cadena 
de caracteres. Una práctica muy difundida es 
identificar los teléfonos por su dirección MAC, 
dado que es un valor único, en tanto que el 
nombre de un usuario, el número de interno 
o una marca pueden resultar ambiguos 
y generar problemas y confusiones durante el 
mantenimiento de la red. 


En Asterisk, lo único que importa en cuanto 
a denominaciones es el nombre del canal. No 
existen los conceptos de usuario, interno O 
extensión. Por otro lado, una extensión tiene 
un significado totalmente distinto del que 
estamos acostumbrados a manejar los usuarios 
de telefonía. En este caso, es el nombre que 
se le da a un grupo de instrucciones en el 
script de programación de la central, y puede 
ser tanto un número como una cadena de 
caracteres alfanumérica. 


Ahora podemos seguir adelante. La configura- 
ción del canal SIP nos permitirá realizar y re- 
cibir llamadas en el aparato identificado como 
teléfono SIP, que pertenece al context grupo 


O PROTOCOLOS DE SEÑALIZACIÓN 






SIP (veremos más sobre el context en los 
Capítulos 4 y 5), con un registro dinámico de 
su dirección IP y con una clave de uso. 


Es importante destacar que la tendencia 
actual es emplear softphones, ya sea como 
una aplicación en la computadora o en un 
smartphone. Un ejemplo de esto es el avance 
de la telefonía a través del popular Skype. 


Un aparato de teléfono IP que emplee SIP ten- 
drá su propia forma de configurarse a través 
de una interfaz, compuesta por una pantalla 
en el mismo teléfono y su teclado. No describi- 
remos las diferentes posibilidades en que esto 
se presenta, porque excede el objetivo de este 
libro, pero sí diremos que tendremos que ajus- 
tar las definiciones del archivo sip.conf con 
los parámetros de configuración del teléfono; 
en especial, el nombre del dispositivo, que será 
empleado como credencial al momento de re- 
gistrarse y solicitar hacer una llamada. Por 
esta razón es fundamental que este nombre 
sea único en la red. 


El archivo sip.conf copiado al directorio / 
etc/asterisk contiene gran cantidad de op- 
ciones y documentación, pero las líneas más 


Se llama protocolo de señalización telefónica al conjunto de reglas y procedimientos 
que permite establecer, mantener y finalizar una llamada. Hay numerosos protocolos, 


y SIP es uno de ellos. Otro famoso es el denominado 
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importantes que permitirán un funcionamiento 
adecuado, junto con las agregadas, son: 


[general] 

context=default 

allowoverlap=n0 

bindport=5060 

bindaddr=0.0.0.0 

srvlookup=yes 

El parámetro srvlookup debe colocarse 
en yes para que la llamada SIP pueda 
realizarse utilizando los nombres de dominio 
de los usuarios SIP en Internet. La sección 
[general] se emplea para las configuraciones 
globales; también existen otras secciones para 


configuraciones puntuales. 


Para ver el estado del canal SIP, podemos 
ingresar el siguiente comando en el CL!: 


CLI> sip show settings 


DD) CENTRAL TELEFÓNICA 


Dispositivo 
softphone 


Los softphones se encuentran en gran cantidad 
de instalaciones Asterisk, ya que son simples y 
cumplen muy bien su función. Además, existe 
una amplia oferta en el mercado de estos 
productos de descarga libre. 


Suponiendo que empleamos la dirección 
IP-1.1.1.1/24 para el servidor Asterisk y la 
dirección IP 1.1.1.10/24 para el softphone, y 
tomando el ejemplo de los parámetros que 
utilizamos en los apartados anteriores, los 
datos que necesitaremos para configurar un 
softphone serán los siguientes: 


e Display Name: SuNombre 

e Username: telefonoSlP 

e Autorization User: telefonoSIP 
e Password: ****** (clave) 

e Domain/Realm: 1.1.1.1 

e SIP Proxy: 1.1.1.1 


Si queremos observar el estado de registro del 
softphone que estamos configurando, podemos 
proceder de la siguiente manera: 





La tarea principal de una central telefónica es encaminar las llamadas para 
interconectar el nodo que origina la llamada con su destino. De esta manera, una 


central conecta ambos extremos en forma dinámica. 
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Arranque Asterisk en consola 
remota y nivel verbose 3: 

iF asterisk -rvvv. 

En el prompt, reinicie los 
componentes: 

> dialplan reload 

> sip reload 


En la ventana principal del 
softphone verá la negociación con 
Asterisk para realizar el registro. 
Cuando lo logre, verá en el prompt 
del CLI de Asterisk lo que se 
muestra en la imagen. 





En caso de habilitar el 
parámetro sipdebug en el 
archivo de configuración 
sip.conf, el despliegue de 
información acerca del proceso 
de registro es mucho más rico. 
El mensaje SIP/2.0 200 OK 
muestra que la conversación 





progresa adecuadamente. 
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PASO A PASO /2 (cont.) 





Canales 

y Dialplan 

Hemos visto que la configuración de los canales 
en Asterisk se logra a través de los archivos de 
configuración, cuyo nombre coincide con el pro- 


tocolo utilizado por el canal; para nuestro caso, el 


50 





Para verificar el estado de la 
registración, utilice el comando: > sip 
show peers 


Para obtener más detalles, emplee 
el comando: > sip show peer 
telefonoSIP 


archivo sip.conf, que está ubicado en el di- 
rectorio /etc/asterisk. En este archivo con- 
figuramos los parámetros relacionados con el 
canal SIP y los dispositivos SIP que empleamos 
en la instalación. 


En una instalación comercial, encontraremos 
otros archivos de configuración de canales, 
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Figura 3. Una 
vista del X-Lite 
y su ventana de 
configuración 
básica con los 
parámetros 
utilizados en la 
instalación de 
prueba. 


como IAX2, que es un protocolo de Asterisk 
con funciones similares a SIP. A través de es- 
tas configuraciones, Asterisk puede comunicar- 
se con los dispositivos, lo que a su vez permite 
que estos se comuniquen entre ellos. 


Los archivos de configuración de canales con- 
tienen la configuración del driver del canal 
(chan_sip.so) y se estructuran en secciones, 
cuyos identificadores se encierran entre corche- 
tes. Por ejemplo, en la sección [general] está 
la configuración global del canal y por defecto 
de los dispositivos, que pueden ser reemplaza- 
dos por otros específicos que figuren en la sec- 
ción correspondiente, más abajo en la estructu- 
ra del archivo, 


Los parámetros de cada canal son evalua- 
dos por Asterisk en el orden que detallamos a 
continuación: 
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EE” 
0 od E 


1. Evaluación de la sección específica. 

2. Evaluación de la plantilla de la sección (si existe). 
3. Evaluación de la sección [general]. 

4. Asignación de los valores por defecto. 


El archivo de configuración del canal inte- 
ractúa con el script de control de la central 
(Dialplan), y así queda definido desde el pun- 
to de vista lógico de qué manera la llamada in- 
gresa y sale de la central. 


En nuestro caso, nos hemos concentrado en el ca- 
nal SIP, dado que es uno de los más utilizados y es- 
tables, y tiene un gran soporte de parte de la co- 
munidad Asterisk. Además, las tendencias actuales 
marcan que los dispositivos sean teléfonos IP y, si 
es posible, softphones. 


51 


€» Configuración de canales y dispositivos 


=————_———=—=_—__—_——_———_—_ >= >= 





No obstante, será necesario interconectar la 
central Asterisk con el mundo exterior para 
poder realizar y recibir llamadas. Esto reque- 
rirá la configuración de hardware específico y 
de otros canales, que no trataremos en este li- 
bro, pero que siguen la misma lógica explica- 
da y no revisten un grado de dificultad que los 
haga inabordables para quienes tienen cono- 
cimientos de telefonía e informática. 


Como vimos anteriormente, el archivo sip. 
conf.sample de Asterisk fue copiado con el 
nombre sip.conf en el directorio /etc/as- 
terisk.A partir de este archivo, que tiene una 
gran cantidad de opciones de configuración, 
de las que normalmente bastarán las que es- 
tán por defecto, construiremos nuestro archivo 
de configuración de canal SIP. 


En el siguiente listado, podemos ver las opcio- 
nes consideradas fundamentales a la hora de 
poner en funcionamiento el canal SIP y que se- 
rán necesarias, como datos, para la configura- 
ción de los dispositivos SIP: 


[general] 


context=unauthenticated; contexto por 
defecto para las llamadas entrantes 


allowguest=no; deshabilitar las llamadas no 
autenticadas 


srvlookup=yes; habilitar búsqueda DNS 
para llamadas salientes 


AZ 


udpbindaddr=0.0.0.0; escuchar UDP en to- 
das las interfaces 


tcpenable=no; deshabilitar TCP 


[office-phone](!); crear una plantilla de 
dispositivos 


type=friend; se valida con el nombre de 
usuario primero, y luego con su IP 


context=LocalSets; punto de ingreso de 
las llamadas en el Dialplan 


host=dynamic; el dispositivo se registra con 
Asterisk 


nat=yes; está en red privada con NAT 


secret=unaclave; clave de seguridad (use 
la propia) 


dtmfmode=auto; acepta tonos DTMF y nego- 
cia en auto 


disallow=all; inicializa los códecs aceptados 
allow=alaw; códec de audio aceptado/reque- 
rido para definir nombres de dispositivo que 
usa la plantilla 


[OA0B1111ED0OB](office-phone) 


[OAOBECDBAFB4](office-phone) 
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Los comentarios aclaran el significado elemen- 
tal de cada parámetro y algunos de ellos ya 
han sido explicados. De los que no vimos, al- 
gunos merecen un párrafo aparte. Por ejemplo, 
el parámetro allowguest=no indica que no 
serán aceptadas las llamadas que no posean 
autenticación. Es una buena práctica definir 
un contexto para tratar por defecto las llama- 
das sin autenticación. Esta definición se hace, 
como se ve en el listado, definiendo un con- 
text en la sección [general]. De esta ma- 
nera, podemos controlar las llamadas que se 
realizan desde dispositivos ajenos a nuestra 
instalación, para evitar que se efectúen utili- 
zando nuestras líneas y a nuestro costo. 


Otra cuestión interesante está relacionada con 
la creación de plantillas o templates, para no 


PASO A PASO /3 


Configuración de canales 
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tener que escribir una y otra vez los mismos 
parámetros en situaciones como la definición 
de dispositivos, donde lo único que cambia es 
el nombre. Estas plantillas se definen con un 
signo de exclamación (!) a continuación del 
nombre de sección. Esto le indica a Asterisk 
que debe considerar esa definición como 
una plantilla, que deberá aplicar cuando sea 
invocada. En los próximos capítulos veremos 
algún ejemplo ilustrativo de esta característica, 
muy útil al programar las centrales Asterisk. 


COMANDOS DE ASTERISK 

Para finalizar este capítulo, conoceremos algu- 
nos comandos de Asterisk relacionados con la 
configuración de los canales. Para esto, debe- 
mos seguir el Paso a Paso que presentamos a 
continuación. 





Conéctese con Asterisk a través 
del comando: 


i'sudo asterisk -r 


E 


E Configuración de canales y dispositivos 
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Reinicie el módulo del canal 
SIP mediante el comando: CLI> 
module reload chan_sip.so 








Verifique el estado del canal 
configurado, ingresando el 
siguiente comando: CLI> sip 
show peers 








En este capítulo analizamos el concepto de canal y su relación con los dispositivos. 


Repasamos los componentes de red necesarios para una instalación con teléfonos IP. 


Exploramos la configuración del tipo de canal SIP y la de un softphone de uso popular. 
Finalmente, vimos algunos comandos Asterisk relacionados. 





> 





Capítulo 4 


Programación 
Asterisk | 
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Conceptos sobre 
el Dialplan 


El motor de los sistemas de telefonía tradicio- 
nales y propietarios es un dominio cerrado y re- 
servado para el fabricante y, hasta donde este 
quiera, a los socios de negocios, distribuidores y 
técnicos de soporte. Además, la mayoría de los 
parámetros que controlan su comportamiento 
vienen dados de fábrica y no es posible modi- 
ficarlos, salvo mediante costosas actualizaciones 
del software del sistema. 


Por el contrario, el corazón de Asterisk, el 
Dialplan, es abierto y totalmente configurable. 
Consiste en una especie de lenguaje de progra- 
mación del tipo scripting, muy flexible y vasto, 
pero que posee cierta estructura, que es la que 
estudiaremos en este capítulo. Permite escribir un 
sistema manejado por eventos, en general exter- 
nos, que especificará cómo serán tratadas por el 
sistema las llamadas telefónicas. 


Su implementación física se realiza a través del 
archivo de configuración extensions.conf, 
que, como otros archivos de este tipo, se encuen- 
tra, por defecto, en el directorio /etc/asterisk. 


La sintaxis del Dialplan está formada por cuatro 
elementos: 


e context (contexto) 

e extensions (extensiones) 

e priorities (prioridades) 

e applications (aplicaciones) 
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La estructura básica del Dialplan se compone de 
una secuencia de contextos, separados por la 
directiva [context], donde la palabra context 
se reemplaza por el identificador, por ejemplo: 
[internos] puede ser el identificador del con- 
texto que agrupe parámetros y directivas que se 
aplicarán al tratamiento de las llamadas dirigi- 
das a los internos o entre estos. 


La función principal de un contexto es agrupar 
los elementos, directivas, etcétera, que se en- 
cuentran en él y aislarlos de los otros contex- 
tos. De esta manera, podremos mantener la in- 
dependencia entre ellos, y lo que suceda dentro 
de un contexto no tendrá impacto ni relación 
con lo que suceda en otro, salvo que lo defi- 
namos o programemos explícitamente. La cade- 
na de caracteres que forma el identificador del 
contexto puede contener cualquier carácter al- 
fanumérico, guiones medio y bajo, sin espacios, 
hasta un máximo de ochenta contando el NULL 
final. Los siguientes nombres están reservados 
para su uso por Astrerisk: 


e [general]: agrupa la configuración de los pa- 
rámetros que se aplicarán a todo el Dialplan. 

e [global]: se hace cargo de las variables glo- 
bales del script. 

e [default]: se ocupa de los valores por defec- 
to de los parámetros empleados por todos los 
segmentos del Dialplan. 


A continuación del identificador de sección 
[globals], se agrupan los parámetros que ac- 
túan como globales para el funcionamiento del 
Dialplan. Estos valores tienen una cobertura 
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sobre todo lo que hagamos en el Dialplan, y al- 
gunos de ellos podrán redefinirse a nivel de los 
contextos particulares, con valores que solo ten- 
drán cobertura dentro de ellos. 


El archivo de configuración del Dialplan contie- 
ne una serie de preconfiguraciones establecidas. 
Entre ellas se encuentra el contexto [default], 
que es el único que existe si no se declara otro. 
Las configuraciones de las extensiones se rea- 
lizarán dentro de él, porque las aplicaciones, 
de manera predefinida, se refieren a él. Cabe 
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destacar que, en muchas instalaciones, este con- 
texto será más que suficiente para definir el am- 
biente telefónico utilizado. En nuestro caso, pu- 
simos como ejemplo otro contexto, llamado 
[internos], bajo el cual podremos incluir to- 
das las configuraciones de prueba necesarias sin 
alterar el estado original del sistema. 


Estos segmentos de script no forman con- 
textos estrictamente hablando, pero agru- 
pan elementos comunes y aislados del resto 
de la programación, así que, por extensión del 
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lenguaje empleado en el Dialplan, se los trata 
como contextos. 


La segunda función para destacar de un contexto 
es mantener la seguridad: forma compartimen- 
tos de código estanco donde es posible separar 
las funcionalidades y privilegios dados, unos de 
otros. Mantener esta seguridad puede hacernos 
ahorrar dinero, pues permite asegurarnos de que 
los permisos otorgados para hacer determinados 
tipos de llamadas no estarán fuera de control. 


CANAL 


Archivo: sip.conf 
[id1 ] 
Context = internos 


Teléfono Id 1 


Teléfono Id 2 
[id2 
== host = dynamic 








Preu Fage HA Cut Text A Cur Foz 
Mnfcut Text To Spell 


Por último, debemos decir que la etiqueta [con- 
text] enlaza las definiciones realizadas en los 
archivos de configuración de canal con las co- 
rrespondientes del Diaplan, es decir, en el archivo 
extensions.conf. Esta relación es muy impor- 
tante porque permite definir el flujo de las llama- 
das a través del sistema Asterisk, determinando 
en qué parte del Dialplan está programada la ló- 
gica que atenderá una llamada que ha ingresado 
por un canal determinado. En el esquema de la 
Figura 4 puede apreciarse esta relación. 


DIALPLAN 


Archivo: extensions.conf 
[ general ] 
s 
[ globals ] 
n 
internos ] 
exten 203, 1, Dial (Sip/Id2) 


Figura 4. Comprender esta relación es clave para entender el funcionamiento de Asterisk. 
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Sintaxis 
del Dialplan 


Dentro de cada contexto hay una secuencia de lí- 
neas estructuradas de la siguiente manera: 


exten => nombre,prioridad,aplicación() 
Como ejemplo, mostramos la siguiente línea: 
exten => primera,1,Answer() 


Aquí, el nombre de la extensión es primera, 
la prioridad es 1 y la aplicación es Answer(), 
que, como podremos imaginarnos, indica que 
hay que responder a esta llamada. 


La directiva exten=> se refiere a exten- 
sión, que en Asterisk se emplea para iden- 
tificar una línea de instrucción que con- 
tiene a los otros dos elementos de la 
sintaxis: la prioridad y la aplicación. 
Como vemos, la línea de programa tiene un 
nombre que a veces se confunde con el núme- 
ro que tenemos que digitar o discar para que el 
teléfono perteneciente a un determinado usua- 
rio comience a sonar, avisando que alguien está 


O ARCHIVOS DE CONFIGURACIÓN 


Al implementar Asterisk, hemos instalado los archivos de configuración de mues- 
tra en el directorio: /usr/src/sistemaasterisk/asterisk/1.8/configs. Podemos co- 
menzar a trabajar a partir de los archivos allíinstalados o crear los propios desde cero. 
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llamando. El nombre es cualquier cadena al- 
fanumérica y sirve de etiqueta para identificar 
el paso del programa o Dialplan en cuestión. 


Luego, separado por una coma, pondremos un nú- 
mero llamado prioridad. Esto también tiende a 
generar confusión, ya que no se trata de una prio- 
ridad para cursar la llamada ni de un identificador 
de privilegio, sino del número de orden del paso 
de programa en cuestión para una extensión dada. 


En cada contexto, podemos tener muchas exten- 
siones, y cada una estar compuesta, a su vez, por 
un determinado número de pasos, distinguidos 


por una prioridad, como vemos en la porción del 
Dialplan siguiente: 


exten => primera,1,Answer() 
exten => primera,2,aplicación1() 
exten => primera,3,otra-aplicación() 


exten => primera,4,Hangup() 
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En este ejemplo, la extensión lleva por nombre 
primera, y su tratamiento se compone de cuatro 
pasos o prioridades, que serán ejecutadas en ese 
orden, para dar el tratamiento definido para esa ex- 
tensión. Este script se ejecutará al ser disparado por 
una llamada, o sea, por el discado de un número 
de teléfono o interno que corresponderá a un des- 
tino al que se quiere llamar. 


Antes de explicar el último elemento de la línea de 
programa del Dialplan, cabe destacar que, para fa- 
cilitar la programación y evitar la redundancia de 
escribir una y otra vez exten => primera, con el 
inconveniente que acarrea la numeración con- 
secutiva al momento de tener que insertar algu- 
na línea intermedia, se ha provisto al lenguaje 
de dos opciones, que se muestran en la siguien- 
te porción del Dialplan: 


O VARIABLES DE CANAL 


Figura 5. 

El archivo 
extensions. 
conf, donde se 
ven algunas 
configuraciones 
por defecto. 


exten => primera,1,Answer() 
same => n,aplicación1() 
same => n,otra-aplicación() 


same => n,Hangup() 


same => repite lo que se ha definido en la línea 
anterior, evitando escribir lo mismo tantas ve- 
ces como pasos hayamos diseñado. El paráme- 
tro n transforma en dinámica la prioridad de la 
línea, con lo cual permite intercalar o modificar 
la secuencia sin renumerar el resto de las líneas. 





Asterisk tiene muchas variables de canal predefinidas que pueden emplearse en el 
Dialplan. Para acceder a mayor información sobre ellas podemos consultar la wiki de 


ISC AA IEA ESC AA TE A EN EME cs 
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Variables en Asterisk 





Algo importante es no olvidarnos de nume- 
rar con 1 la primera línea de programa de la 
extensión, o esto no servirá de nada. Asterisk 
calcula las prioridades incrementando en uno 
el resultado anterior, y por eso se requiere te- 
ner la referencia de la primera línea; de lo 
contrario, no podrá expandir el código como 
corresponde. 


Como en todo lenguaje de programación, el 
Dialplan cuenta con estrategias para controlar 
el flujo del programa. Todas ellas, implementa- 
das con directivas, necesitan conocer los pun- 
tos de acceso del flujo para poder dirigirse a él 
y retornar al punto de partida, si es necesario. 
Para esto, en programación es usual emplear el 
concepto de label o etiquetas, que identifican 
estos puntos destacados en el flujo de progra- 
ma. Este concepto se implementa en el Dialplan 
agregando un parámetro más a la prioridad. El 
formato general para la extensión de ejemplo 
será el siguiente: 


exten => primera,n(label),application() 








De esta manera, podemos etiquetar una línea 
determinada con el propósito de referirnos a 
ella en otros pasos de la misma extensión, en 
pasos de otras extensiones o, incluso, desde 
otros contextos. Así es posible saltar de un pun- 
to a otro a la manera GolTo. 


El último elemento que conforma la sintaxis, 
aplicación(), determina la acción que se rea- 
lizará cuando se ejecute la línea en cuestión. 
Este elemento es el más rico y complejo de to- 
dos y, por lo tanto, le reservamos un apartado 
dedicado a su presentación y explicación. Antes 
examinaremos un poderoso concepto de todo 
lenguaje de programación, que facilita la codi- 
ficación, permite programar con mayor elegan- 
cia, y ayuda a reducir el tamaño del programa, 
las variables y los patrones. 


Variables 
en Asterisk 


Una variable es una especie de contenedor de 
valores, donde estos pueden cambiar, pero el 
contenedor (su definición o identificación) no. 
Es un concepto que quienes han programado 


INSTRUCCIONES PRECISAS 


Asterisk requiere que se le explicite qué debe realizar y cómo debe proceder con cada 
situación que se le presente en cuanto al manejo de las llamadas; de otro modo, las 
desconectará. Este comportamiento es distinto de las centrales PBX propietarias. 
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alguna vez comprenderán rápidamente. Esta 
herramienta no se encuentra en la programa- 
ción de centrales PBX propietarias y será muy 
útil durante la implementación de la lógica de 
atención de llamadas. 


En general, lo que cambia entre los diferentes 
lenguajes es la forma de definir estas variables 
y la recuperación de los valores almacenados 
en ellas. También, como en muchos sistemas, 
hay nombres reservados por la misma platafor- 
ma para usos propios. Las variables del sistema 
están definidas en mayúsculas y no deben ser 
utilizadas por el programa de usuario. Veremos 
mediante ejemplos la sintaxis en Asterisk: 


exten => 2000,1,Set(JOSE=SIP/OADCBB 
OAEFBC) 


same => n,Dial($(JOSEJ) 


En esta porción de código, en la exten- 
sión 2000, hemos declarado e inicializado la 


O ACCESO A ASTERISK | 


variable JOSE (la variable jose es distinta de 
JOSE), y en la siguiente línea la hemos utiliza- 
do, invocando su contenido, como argumen- 
to destino de la aplicación Dial1(), que vere- 
mos en detalle en el apartado correspondiente 
a las aplicaciones. 


Suponemos que José tiene un terminal SIP y 
lo hemos identificado con la variable JOSE. Si 
José cambia su terminal, solo deberemos cam- 
biar el valor asignado a la variable, y no, en 
cada lugar del Dialplan donde hayamos em- 
pleado la dirección de su terminal. Esto facilita 
el mantenimiento y disminuye la probabilidad 
de errores humanos en el programa. 


Como vemos en la segunda línea del ejemplo, 
el contenido de la variable se invoca encerran- 
do entre llaves su valor y anteponiendo el sig- 
no $ al conjunto. 


En Asterisk se definen tres tipos de variables, 
que detallamos a continuación: 


e Variables globales 
e Variables de canal 
e Variables de entorno 





Hay tres maneras de ejecutar Asterisk: iFasterisk corre como un demonio y devuelve 
el control al shell de Linux; ltasterisk -c se ejecuta y devuelve una consola local para 
su manejo (*CLl>); y + asterisk -r se conecta en forma remota a un Asterisk que se 


está ejecutando en otra máquina. 
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Figura 6. Ejemplos MEA 
de uso de variables 


[trunkint ] 


en el archivo 


exten => 


extensions.conf exten 
preconfigurado. trankid] 


_2611..1.Hacrotdundi-el61., 
2 _3011.,1,Dial (GiGLIBALIOTRUNAR 17-51 FILTERCO=3, 


File: releraslerizkreztensions.conf 


¿ International long distance through trunk 


¿Long distance context accessed Lhrouqh Lrunk 


a A 
exten => 


[trunklocal] 


¿Local seven-digil dialiny accezsscd Lhrough 


E 
exlen 


Las variables globales son visibles por todos 
los canales definidos en Asterisk y deben de- 
clararse en el contexto [globals] al principio 
del archivo extensions.conf: 


[globals] 


JOSE=SIP/OADCBBOAEFBC 


Por el contrario, las variables de canal solo 
son visibles en los canales donde se han decla- 
rado y son válidas durante el desarrollo de la 
llamada que involucra estos canales solamen- 
te. Se inicializan mediante la aplicación Set(): 





_HIAXXAXE RX 1 Hacroldundi-e164,50EXTEN:111 
> IAEA, 1 Dia 1 SA GLOBAL ETRUAA DS XIEXTEN : S0GLOBAL € TRUNHKMSD 0 


Llrunk interface 


SNXXEXXX, 1, Dia 1 CSTGLOBAL(TRURE 1 -S1EXTEN:S10GLOBALOTRUNEASDI FF 


AT OA AI 
Exit A Justify 


kead File j 


AT ES 
A E 
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exten => 1032,1,Set(Intentos=10) 


Las variables de entorno se refieren a las ho- 
mónimas que encontramos en la plataforma 
Linux. Si bien no son muy utilizadas, Asterisk 
proporciona una manera de acceder a las va- 


riables de entorno de Linux, mediante la apli- 
cación ENV(). 


Su sintaxis es ENV(var), donde var es la va- 
riable de entorno Linux referenciada, y su con- 
tenido es indicado como: $fENV(var)). 


ACCESO A ASTERISK |! 


Cuando invocamos la ejecución de Asterisk, tenemos la oportunidad de establecer 
el nivel de diálogo informativo (verbosidad). Por ejemplo, para invocar a Asterisk con 
una consola de comando local y nivel 2, existe el siguiente comando: J! asterisk -cvv. 
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Patrones 
en Asterisk 


Otra herramienta muy poderosa dentro de un 
lenguaje de programación es la posibilidad 
de definir en forma dinámica valores que no 
se conozcan a priori o que sean rangos ex- 
tensos o definidos al momento de ejecutar 
una aplicación. 


El emparejamiento de valores se define a 
través de un guión bajo ubicado delante de 
ciertos caracteres o términos, como podemos 


Para ejemplificar este concepto veremos, 
a continuación, algunos usos en el Dialplan: 


exten => _ZXN, 
Playback(archivo-de-audio) 


Mediante el patrón _ZXN, hacemos referencia 
a una extensión que comience con cualquier 
número entre 1 y 9, siga con cualquier núme- 
ro entre 0 y 9, y finalice con cualquier núme- 


observar en la Tabla 1. ro entre 2 y 9. Asterisk realiza la evaluación de 





CARÁCTER DEFINICIÓN 


. (punto) 


Es un carácter comodín, que representa uno o más dígitos cualesquiera. 


I (signo de 
exclamación) 


Otro comodín, pero a diferencia del anterior, representa a ninguno o más 
caracteres cualesquiera. 


XK Representa cualquier dígito entre 0 y 9. 
Z Representa cualquier dígito entre 1 y 9. 
N Representa cualquier dígito entre 2 y 9. 
[03-7] Representa una serie de dígitos o rango de ellos. Aquí representa el O y un 


número entre 3 y 7. 


Tabla 1. Estos caracteres permiten hacer referencia a valores desconocidos. 
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Figura 7. Ejemplos 
de uso de patrones 


File: r“elecrasleriskrsexrtensionsz.conf 


5 Lhe Linezone is siquoificant le.q. calls to "SayllnixTineti”, etcd uill 
E E E A A A A E 


¿oa mechanisa for tinezones. 


en el archivo 
extensions.conf EU 


preconfigurado. 


A AE A E AA A A 
: for other languages if there's no pause before the synchronizing beep. 


¿ use the tinezone esszociated with the extension (sip only?. or systen-wide 
; default if one hasn'L been sel. 


HE Gel Help EN Uritelut 
Exit y Justifu 


estos patrones de la misma manera que los 
motores de ruteo lo hacen con las rutas a las 
redes. Si dos patrones se parecen, Asterisk to- 
mará el más específico. 


Aplicaciones 


Las aplicaciones son las rutinas que se ejecu- 
tan para realizar las acciones requeridas por la 
lógica del Dialplan. Su estructura recuerda a las 
llamadas a procedimiento del lenguaje C, dado 
que se invocan con un identificador seguido de 
paréntesis, dentro de los cuales, en caso de que 
existan, se sitúan los argumentos que deben 
pasarse a estas llamadas, separados por coma 
(,) O barra vertical (|). Los nombres que utili- 
zamos en el apartado anterior son verdaderos 
identificadores del Dialplan de Asterisk. 


En la siguiente porción del Dialplan (que pue- 
de ser lo único que tengamos en él, tratándo- 
se entonces de la lógica más simple que poda- 
mos implementar), vemos el uso de tres de las 
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aplicaciones más simples (en el desarrollo de los 
próximos capítulos, introduciremos otras más): 


[internos] ; nombre del contexto (será refe- 
renciado desde el archivo tipo_canal.conf) 


exten => 70,1,Answer() 
same => n,Playback(archivo-de-audio) 
same => n,Hangup() 


En la primera línea, cuando el canal asociado 
con el identificador del contexto donde se en- 
cuentra esta porción del Dialplan está llaman- 
do (ringing en la jerga telefónica), se emplea 
la aplicación Answer() (no requiere argumen- 
tos) para atenderlo y conectarlo. Esto es nece- 
sario si luego vamos a tomar más acciones so- 
bre esta llamada, como en este caso. 
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GMU nano 2.2.6 File: 


¿ ANI context: use in the sane uay as "tine" above 


lani] 
exten => 
exten 


, -190000(ani).No0ptANI: SCEXTEN)) 
Ue (0.25) 

AP () 

¿M, (um fron) 
¿n,SayDigits(S5(CALLERID(ani))1) 
,n,Wait(1.,25) 

JA (S(CALLERID(ani)1) 
»U () 


exten => 
exten => 
exten => 
ecxten => 
exten > 
ecxten => 


HH 


For more information on applications, 
TES A A 


Just type 


"core show application <comnand>"” will show details 

use that particular application in this file, 
"core show functions” 
"GRATO 
Exit J 


Uri lellat 
Justify 


Head File 
TS EE 


Prev Page 
Next Page 


E Ñ Ñ 
En la siguiente línea, la aplicación 
Playback(ruta/archivo-de-audio)  re- 
producirá sobre el canal conectado por la apli- 
cación Answer() un archivo de audio desig- 
nado como argumento. Este argumento puede 
indicarse como una ruta de directorios com- 
pleta o como el nombre del archivo con ex- 
tensión o sin ella. En caso de tener varios ar- 
chivos de sonido iguales, pero con diferentes 
codificaciones (estos se manifestarán con di- 
ferentes extensiones en el nombre del archi- 
vo), Asterisk tomará el archivo más adecuado, 
sobre la base del uso de los recursos. En este 
caso, irá a buscarlos al directorio de sonidos 
por defecto, que en una instalación estándar 


es /var/lib/asterisk/sounds/. 


Finalmente, en la última línea de este contexto 
se emplea la aplicación Hangup(), que en gene- 
ral no utiliza argumentos para desconectar el ca- 
nal de la llamada en curso. Esto asegura una fi- 
nalización adecuada de la llamada y evita dejar 
conectados los canales a la lógica del Dialplan, 
hecho que podría producir consecuencias 
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"core show applications” 





retcsasterisksextensions.conf 


Figura 8. 
Ejemplos de uso 
de aplicaciones 
en el archivo 
extensions.conf 
preconfigurado. 


at y$ 


of how ou 
the dial plan. 
will list all dialplan functions 


Cut Text 
AT 


Cur Pos 


To Spell 


desagradables en el funcionamiento del sistema. 
Por esto último, se recomienda el uso de esta 
aplicación al final del contexto para terminar la 
rutina incorporada en él. 


Saltos 
incondicionales 


Tal como en otros lenguajes de programación, 
en el de Asterisk también encontramos senten- 
cias para romper el flujo secuencial de instruc- 
ciones. Veamos el formato de esta instrucción: 


same => n,Goto(context,extension,pri 
ority) 


La sentencia Goto realiza un salto incondi- 
cional al contexto indicado como primer ar- 
gumento y, dentro de él, a la extensión indi- 
cada en el segundo argumento y al número 
de secuencia de dicha extensión, indicada por 
el tercero. Si solo incluimos un argumento, el 
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: . GHU nano 2.2.6 File: retcrasterisks-extenslions.conf 
Figura 9. Ejemplos 
de uso de saltos : Sample entries for extensions.conf 
en el archivo Ldundi el64- canonical] 
include > stdexten 
extensions.conf ; 
s List canonical entries here 
preconfigurado. | 


sexten => 12564206000,1 ,Gosub(6000,stdextent1AX2f 00) ) 
cexlen _1256428H50XX,1,Dia1C1AXZ+otherboxs+S1EXTEN:77) 


ldund i-e1h4-cuslLoners ] 


 1£ you are an ITSP or Reseller, list your custoners here. 
sexten > _125642H8h000,1,Dia1(SI1P-custoneri ) 


cjexten => _12564286001,1,.Di1a1(15X2-custoner2) 
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salto se realizará al número de secuencia, in- 
dicado por ese argumento, de la extensión co- 
rriente, dentro del mismo contexto. Un segun- 
do argumento daría cuenta de un salto a una 


secuencia de otra extensión, siempre dentro exten => 911,1,Goto(Exepciones,emerge 
del mismo contexto. ncias,1) 


same => n,Playback(archivo-de-audio) 


same => n,Hangup() 


Para ejemplificar el uso de esta sentencia, utili- 
zaremos el siguiente listado de un Dialplan: 


[Excepciones] 
[internos] 


exten => emergencias,1,Answer() 


same=> n,Playback(archivo-de-audio- 


exten => 70,1,Answer() recepción911) 


O CONVERSIÓN DE AUDIO 


Cuando se debe reproducir un archivo de sonido, Asterisk lo convierte previamente a 
su formato nativo. Para hacerlo, selecciona el archivo, entre los disponibles, cuyo for- 
mato permita esta conversión con el mínimo uso de recursos de la CPU. 
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Una llamada que ingresa por el contexto [in- 
ternos] a la extensión 911 será atendida en 
el contexto [Excepciones], donde se repro- 
ducirá un mensaje (archivo-de-audio-re- 
cepción911) y, luego, seguirá el curso según 
la lógica diseñada para ella. El salto se ha reali- 
zado desde el contexto [internos] al contex- 
to [Excepciones], a la extensión cuyo nom- 
bre de identificador es emergencias y en la 
secuencia 1 de esta. 


Aplicación 
Dial() 


Podríamos decir que Dial() es la aplicación 
principal de Asterisk porque permite interco- 
nectar los extremos que pretenden comunicar- 
se. Además, realiza la conversión de los distin- 
tos formatos y protocolos empleados por los 
canales (analógicos, digitales convencionales, 
voz sobre IP, etc.). Es una aplicación muy pode- 
rosa y versátil, por lo que requiere de algunos 
argumentos para cumplir su misión. Su sintaxis 
es la siguiente: 


Dial(destino,timeout,opción,URT) 


O TRANSPORTE CON lAX2 


El primer argumento es indispensable, y repre- 
senta el destino que se intenta alcanzar, es de- 
cir, el extremo al que se está llamando. Este 
argumento es compuesto y tiene la siguiente 
estructura: 


tipo-de-transporte/ 
dirección-recurso-remoto 


Como ejemplo, supongamos que al llamar a 
la extensión 701, queremos comunicarnos con 
un terminal telefónico IP o un softphone. El 
tipo de transporte o tecnología de canal em- 
pleado será SIP. La dirección del recurso esta- 
rá dada, en este caso, por su identificación O 
nombre; en el caso de otras tecnologías, como 
la DAHDI para transporte analógico, será el nú- 
mero del canal empleado. El identificador, como 
vimos en el Capítulo 3, deberá ser algo único, 
que permita designar univocamente al recurso, 
como, por ejemplo, su dirección física o MAC. 
Así es como se verá en el Dialplan: 


exten => 701,1,Dia1(SIP/OA00BF4E0C1) 


Existe una estrategia muy utilizada que se de- 
nomina cobertura y consiste en llamar a múl- 
tiples terminales telefónicos simultáneamente 





Asterisk permite utilizar diferentes tipos de transporte, lo que posibilita la interco- 


nexión de distintas tecnologías. Un formato que permite la interconexión entre siste- 


mas Asterisk es el denominado lAX2. 
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Figura 10. 
Distintas ; 
llamadas a la 


[dundi-el1641-canonical] 


¿include > stdexten 


aplicación Dia1(). 
Notemos los 


¿ List canonical entries 


sexten -> 


diferentes canales 
empleados. 


¿exten 


A 


jexlen 
jexten => 


con el objeto de ser atendidos por el primer 
agente libre que se presente en el destino lla- 
mado, por ejemplo, un centro de atención de re- 
clamos. Con esta aplicación, sin mucho esfuerzo 
adicional, podremos implementar esta estrate- 
gia. La codificación se verá así: 


exten => SoporteTecnico,1,Dial(SIP/O0E 
DABOODCEF8SIP/OA00BF4E0C1) 


Simplemente, debemos concatenar los des- 
tinos mediante el operador 8. Lo que suce- 
derá cuando se curse la llamada será que 
todos los destinos concatenados van a So- 
nar (ringear, en la jerga telefónica) al mis- 
mo tiempo, y cuando uno de ellos sea 


O INFORMACIÓN DE SEÑALIZACIÓN 
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File: retcrasterisks-extenslions.conf 


¿ Sample entries for extensions.conf 


here 


> 12564206000,1 ,Gosub(6000,stdextent1áAX2f00)) 


> _125642AH50XX,1,Dia1C1AXZ+otherboxsS1EXTEN:77) 


list your custoners here. 


? _125642H8h000,1,Dia1(31P/custoneri) 
_12561286001,1,Di1a1(C15X2-custonerZ) 


j A OMA 
Exit JENS" 
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atendido, los demás dejarán de ser alertados. 
No desarrollaremos este tema en detalle, pero 
para tener una idea de la potencia de esta apli- 
cación, mostraremos un ejemplo para el caso de 
llamar a un terminal analógico externo a la cen- 
tral, empleando la aplicación Dia1(): 


exten => 
D1/7/08109998018) 


Soporte,1,Dial(DAH 


Esta llamada será cursada al grupo o canal 7 
de un transporte DAHDI y al número telefó- 
nico 0810-999-8018. El encaminamiento de 
este destino es responsabilidad de las centra- 
les públicas a las que deberemos interconectar 
nuestra central Asterisk mediante la tecnología 


Algunos sistemas telefónicos solicitan información de señalización durante el estableci- 
miento de las llamadas. Asterisk dispone de la aplicación Progress(), que provee infor- 
mación sobre el progreso de la llamada al canal origen, antes de conectarla con Answer(). 
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adecuada, por ejemplo, una línea telefónica 
convencional o un troncal El. 


En el ejemplo de la estrategia de cobertura, los 
terminales telefónicos son alertados indefini- 
damente, y el programa queda estancado en 
ese punto hasta que algún agente atienda o 
corte la llamada. Para evitar esto, podemos in- 
dicar el tiempo máximo durante el cual Asterisk 
alertará a los terminales remotos, luego de lo 
cual se terminará la llamada y se procederá a 
procesar la siguiente secuencia en la extensión. 
Esto se efectúa mediante el segundo argumen- 
to de la aplicación Dia1(), el timeout, expre- 
sado en segundos: 


exten => 701,1,Dia1(SIP/0A00BF4E0C1,8) 


En nuestro ejemplo, hemos agregado un ti- 
meout de 8 segundos, luego del cual se cance- 
lará la acción de la aplicación y se continuará 
con la siguiente secuencia. 


Desde el punto de vista de la persona que 
llama, este comportamiento puede parecer 
un poco rudo, puesto que la llamada se cor- 
tará sin explicación alguna. Una alternati- 
va más elegante es proporcionar alguna pista 


O SEGURIDAD DEL SISTEMA 


de por qué se ha decidido terminar con la lla- 
mada. También puede suceder que el destino 
que se desea alcanzar se encuentre ocupado. 
Cualquiera sea el motivo, Asterisk lo indicará 
a través de una variable de estado del sistema 
llamada DIALSTATUS, de la que nos ocupare- 
mos en el próximo capítulo. 


Este ejemplo muestra una manera en que po- 
demos resolver esta situación: 


exten => 701,1,Dial(SIP/OA00BF4E0C1,8) 
same=>n,Playback(aviso-estoy-ocupado) 


same => n,Hangup() 


Luego de superados los 8 segundos, se cancela- 
rá la llamada, cesará el alerta al terminal SIP y 
se reproducirá un mensaje de ocupado. 


Cabe destacar que podemos poner cualquier 
mensaje independientemente de la causa del 
cese del alerta. En el siguiente capítulo, veremos 


Como en todo sistema, la seguridad debe tomarse seriamente en Asterisk. Podemos 





consultar las consideraciones básicas de seguridad para un sistema Asterisk de telefo- 


nía en: https://wiki.asterisk.org/wiki/display/AST/Important+Security+Considerations. 





FU 
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una solución más real a esta situación, median- 
te el uso del estado de la variable DIALSTATUS. 


El argumento denominado URI (Uniform 
Resource Identifier) se emplea para incluir, por 
ejemplo, la dirección SIP, y no es muy utiliza- 
do todavía. En tanto que el argumento opcion 
toma varios valores. El valor m es muy popular, 
y habilita la reproducción de música en espera 
hacia el terminal llamante, mientras se aguar- 
da que el extremo remoto atienda la llamada. 


Si queremos saltear algún argumento, simple- 
mente dejamos un espacio entre dos comas, 
donde va el argumento esperado, y este toma- 
rá el valor predefinido (si existe) o no quedará 
especificado. Esto es similar a lo que sucede en 
otros lenguajes de programación. 


EJEMPLO DE CONTEXTO DEL DIALPLAN 
Concluiremos este apartado con un resumen de 
las modificaciones que hemos explicado en un 
ejemplo de contexto del Dialplan. 


Supongamos que estamos programando un 
nuevo contexto dentro de un Dialplan existen- 
te y agregamos los conceptos que acabamos 
de estudiar: 


O COMANDO ÚTIL 


Para conocer el costo que lleva la conversión de archivos de sonido, en términos de recur- 
sos de cómputo, podemos utilizar el comando show translation de Asterisk, que repor- 
ta los milisegundos consumidos en la transcodificación de un segundo del audio origen. 
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[internos] 


exten => 70,1,Answer() 
same => n,Playback(archivo-de-audio) 
same => n,Hangup() 


exten => 911,1,Goto(Exepciones,emerge 
ncias,1) 


exten => Soporte,1,Dial(DAH 
D1/7/08109998018,10) 


exten => SoporteTecnico,1,Dial(SIP/O0E 
DABOODCEF8SIP/OA00BF4E0C1,30) 


same => n,Playback(aviso-estamos-to- 
dosOcupados-disculpeLasMolestias) 


same => n,Hangup() 


exten => 701,1,Dial(SIP/OA00BF4E0C1,8) 





AS 
AE 
OSI SOS 
QQ 
Ez A —====== A 
e Programación de Asterisk | ===> ========= 
nerginag incls/+suitsrsigpats fron oldílaci-builtin-h-bubble) to neulacl-buil . 
tin-h- bubble) context, registrar pbx conf ig Figura 1 Esta 
ñdded extension 'h? priority 1 to ael-builtin-h-bubble ] 
ñdded extension *h* priority 9991 to acl-builtin-h- bubble salida podrá 
Added extension '*h! priority 9992 aecl-builtin-h-bubbhle 
ñdded extension 'h' priority 9993 to ael-builtin-h-bubble 
ñNdded extension *h* priority 9991 to acl-buíltin-h- bubble observarse 
Added extension 'h' priority 9995 aecl-bhuiltin-h-bubhle a ' 
ñdded extension 'h' priority 9996 to ael-builtin-h-bubble iniciando Asterisk 
Registered extension context 'parkedcalls'; registrar: fealures 
nerging incls/suits/igpats fron oldfíparkedcalls) to neulparkedcalls) cont 
ara» Sn ls veo con el comando 
ñdded extension '?700*” priority 1 to parkedcal!ls A 
Registered extension context 'app dial gosub virtual context"; registrar CLI, asterisk 
app_ dial 
nerging inclsssuits-igpats from oldí(app_dial_gosub_virtual_context) to ne -VVVVC. 


wlapp dial gosub virtual context) context, registrar pbx conf iy 
ñdded extension 's' priority 1 to app_dial_gosub_virtual_context 
Tine to scan old dialplan and nerge leftovers back into the neu: 0,0101 


Tine to restore hints and suap in neu dialplan sec 
Tine lo delete the old dialplan: 0.000703 sec 
Total tine nerge_contexts_delete: 0.0Z1313 sec 





same=>n,Playback(aviso-estoy-ocupado) same => n,Hangup() 
same => n,Hangup() 


Una vez que hayamos guardado los cambios 
del archivo extensions.conf, para que ten- 
[Excepciones] gan efecto, debemos recargar el Dialplan. Esto 
se puede hacer en caliente de dos formas. 
exten => emergencias,1,Answer() Desde el prompt de control de Asterisk (CLT»): 


same => n,Playback(archivo-de-audio- CLI> dialplan reload 
recepción911) 
O desde el shell de Linux: 


same => n,Playback 
(archivo-de-audio-saludo) $ sudo /usr/sbin/asterisk -rx “dial- 
plan reload” 


O RESUMEN 


El Dialplan, corazón de Asterisk, nos permite implementar la lógica de funcionamien- 
to de la central telefónica. Hemos visto su estructura, sintaxis y componentes básicos, 





como así también la relación con otro componente principal de Asterisk, los canales. 
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Introducción 


Asterisk presenta estructuras y sentencias 
similares a otros lenguajes de programación. 
Lo que en estos se denomina instrucción oO 
sentencia, en Asterisk se implementa mediante 
las aplicaciones, algunas de las cuales hemos 
visto anteriormente, en el Capítulo 4. En este 
capítulo, estudiaremos otras aplicaciones 
más complejas, que permitirán darles una 
mayor riqueza a los programas que podamos 
implementar en nuestro trabajo. 


las estructuras y aplicaciones que proporciona 
Asterisk, sino solo mostrar la lógica que hay 
detrás de ellas y la manera de emplearlas. 
Debemos aclarar que es indispensable contar 
con ciertos conocimientos generales sobre 
programación para poder desarrollar con éxito 
un Dialplan funcional. 


La documentación de Asterisk, proporcionada 
en el sitio web oficial, es el lugar adecuado 
para consultar acerca de todas las aplicaciones 
y las estructuras disponibles en la aplicación. 


Dado que la información se actualiza con 
frecuencia, sugerimos, decididamente, su 
revisión frecuente. 


Tanto este capítulo como el anterior no 
pretenden ser un listado exhaustivo de todas 
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Figura 1. En www.asterisk.org encontraremos información actualizada sobre las aplicaciones. 
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> BASE DE DATOS ASTERISK (ASTDB) 


Plantillas 


Cuando trabajamos con los archivos de confi- 
guración y tenemos que repetir parámetros, po- 
demos utilizar plantillas para simplificar nues- 
tra tarea. Esta herramienta permite declarar una 
sección como una plantilla y, luego, utilizarla a 
modo de definición para incorporar los paráme- 
tros configurados en ella. 


A continuación, presentamos un ejemplo clá- 
sico de plantilla, mencionado en muchos otros 
libros, sobre la configuración de los paráme- 


tros de terminales telefónicos, en este caso, 
teléfonos SIP: 


[terminales](!) ; Este signo (!) trans- 
forma la sección en una plantilla 


type=friend 
context=internos 
host=dynamic 


disallow=al1 


allow=ulaw 
dtmfmode=rfc2833 


secret=unaclave 


Agregando un signo de exclamación (!) luego 
del nombre de la sección, declaramos la sección 
como una plantilla. Ahora veremos cómo se uti- 
liza en la siguiente porción del Dialplan: 


[30301(terminales) 
mailbox=3030 
[20201(terminales) 
mailbox=2020 
[1010](terminales) 


mail1box=1010 


Asterisk proporciona un mecanismo para almacenar valores que, luego, pueden ser 


empleados en el Dialplan. Se trata de una base de datos denominada 


formato es 


RedUSERS: 


, CUyO 


>; Programación de Asterisk ll 





Al emplear el nombre de la plantilla como atributo 
del nombre del contexto [3030], incorporamos 
los parámetros definidos en aquella dentro de 
este. Ahora, si tenemos que hacer un cambio que 
afecte a todos los terminales, solo modificamos 
la plantilla, recargamos el Dialplan, y el cambio 
se habrá aplicado a todos los contextos donde se 
usó la plantilla en la declaración. 


Directiva include 


En ocasiones, resulta útil incorporar secciones o 
contextos definidos dentro de otros contextos, 
a modo de la expansión de librerías que 
permiten algunos lenguajes de programación, 
como C. Para hacerlo, Asterisk proporciona la 
directiva include. 


Cuando dentro de un contexto invocamos esta 
directiva, seguida del nombre de otro contex- 
to, podemos incluir las extensiones de este úl- 
timo en el primero. De esta manera, habilita- 
mos sus extensiones para ser llamadas desde 


GAU nano 2.2.6 File: «etec-asteriskrextenslons.conf 
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el primer contexto. La sintaxis para hacer esto 
es la siguiente: 


include=> ventas 


Donde ventas es el identificador del contexto 
que se desea incluir. 


Asterisk evalúa, en primer lugar, las extensiones 
propias del contexto; si no tiene éxito, lo hace 
con las de los contextos incluidos, en el orden 
en que estos aparecen en la configuración. 


Aplicación 
GoSub() 


En general, cuando programamos, tenemos 
que realizar algunas tareas repetitivas en mu- 
chas partes del programa, y para esto emplea- 
mos las subrutinas. Asterisk proporciona la 
aplicación GoSub(), que implementa esta fun- 
cionalidad permitiendo el procesamiento de 


Sip. conf 1 


Figura 2. Esta 
directiva es muy 
potente y permite 
A incluir código 


disponible en otras 
secciones. 
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una cápsula de código que realiza una deter- 
minada tarea, y devuelve un resultado o esta- 
do que luego es utilizado en el curso principal 
del programa. 


Una subrutina se escribe como cualquier 
porción de código del Dialplan. Sin embargo, 
su código suele definirse en un contexto 
aparte, que se nombra de alguna manera 
particular para facilitar su reconocimiento. La 
porción de Dialplan que sigue nos muestra una 
subrutina y la llamada a ella desde el curso 
principal del Diaplan: 


[subAviso] ; definimos un contexto 
aparte para la subrutina 


exten => inicio,1,Dial($fFede),10) 


same => n,Gotolf($[“$[DIALSTATUS)” = 
“BUSY” ]?ocupado:nodisp) 


same => 
disponible.wav) 


n(nodisp),Playback(no- 


same => n,Hangup() 


> VARIABLES DE CANAL 


Una variable de gran utilidad es la denominada 


same => n(ocupado),Palyback(ocupado. 
wav) 


same => n,Hangup() 


exten => 701,1,G0Sub(subAviso,inicio,1()) 


Cuando se llama a la extensión 701, se 
realiza una llamada a la subrutina subAviso, 
ingresando en ella en la primera secuencia de 
la extensión inicio. Dentro de los paréntesis 
se colocan los argumentos, que son los valores 
de las variables que la subrutina espera, si es 
que los hay. En este caso, la subrutina no espera 
ningún valor, por eso dejamos los paréntesis 
vacíos o, directamente, los omitimos. 


En este ejemplo, la subrutina llama al canal 
definido en la variable Fede, alerta durante 10 
segundos y, si no logra una respuesta, ejecuta 
el salto condicional sobre el valor de la variable 
DIALSTATUS. Según sea el valor de esta variable, 
BUSY u otro (no disponible), se reproducirá un 
mensaje y se desconectará la llamada. 


. En ella se almacenan los dígitos 


que se marcan al llamar a una extensión. Esto tiene la ventaja de que permite emplear 


el número para un posterior procesamiento. 
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Si tenemos alguna experiencia con subrutinas, 
notaremos que falta un elemento importante. 
Cuando se llama a una subrutina, es para 
realizar una tarea, en general, repetitiva, y Se 
espera que el control del flujo del programa 
sea devuelto a la instrucción siguiente a 
la sentencia en que se ha llamado a dicha 
subrutina. Entonces, necesitamos una forma 
de indicar que ha terminado la tarea, y que 
es necesario retornar y devolver o no un valor 
como respuesta. 


Para ver este concepto de manera práctica y 
conocer el procedimiento que permite pasar 
argumentos a una subrutina, estudiaremos el 
siguiente código: 


[subDial] 
exten=>inicio,1,Dial($fARG1), HLARG2)) 


same => n,Return() 
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? acne=ex Lens 


¿include 


[subAviso] 
exten => inicio,1,Playback($fARG1)) 


same => n,Hangup() 


exten => 701,1,G0Sub(subDial,inicio,1 
($([Fede),30)) 


same => n,GoSub(subAviso,inicio,1l(no- 
disponible.wav)) 


En este caso, llamar a la extensión 701 hace 
que se llame a la subrutina subDial, que 
ejecuta la aplicación DIAL(). En la llamada 
GoSub(), pasamos dos argumentos: el canal 
($[Fede)) y el tiempo de alerta al terminal 
remoto (30 segundos). Transcurrido este 
tiempo sin obtener una respuesta, se procesa 
la aplicación Return(), que permite volver a 
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la secuencia que sigue a la llamada. Es decir, se 
ejecuta otra llamada, pero ahora a la subrutina 
subAviso, pasándole como único argumento 
el mensaje por reproducir. Finalmente, luego 
de reproducir este mensaje, la llamada 
es desconectada. 


Notemos que los identificadores de variable 
ARG1, ARG2, .., ARGn están reservados para 
alojar los parámetros que se pasen a la 
subrutina llamada. Estos contenedores se 
llenarán con el valor pasado según su posición; 
es decir, el primer parámetro irá a ARG1, el 
segundo a ARGZ2, y así sucesivamente. 


Para discriminar si el terminal remoto está 
ocupado o no disponible, empleamos la variable 
DIALSTATUS, que será posicionada en un valor 
cuando se ejecute la aplicación Dia1() y no se 
obtenga respuesta desde el remoto. Así estará 
disponible cuando se ejecute la aplicación 
Return(), y su valor reflejará el estado en que 
se encuentra el terminal remoto. 


Para utilizar esta información en nuestro 
código y realizar un salto condicional sobre él, 
podemos pasar este valor como respuesta de 
la aplicación Return(). 


> MANIPULACIÓN DE VARIABLES 


Al recuperar el valor de una variable, podemos manipularlo. Por ejemplo, si discamos 


, Asterisk lo almacenará en la variable 
, recuperamos el número 


se invoca el valor 
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A continuación, veremos cómo quedará el 
código de ejemplo al incorporar este nuevo 
concepto: 


[subDial] 
exten=>inicio,1,Dial($fARG1), $(ARG2)) 
same => n,Return($fDIALSTATUS)) 
[subAviso] 

exten => inicio,1,Playback($fARG1)) 


same => n,Hangup() 


exten => 701,1,G0Sub(subDial,inicio,1l 
($([ Fede), 20)) 


same =>  n,Set(MSG=$(IF($[$(GOSUB_ 
RETVAL)=BUSY]?o0cupado:nodisp))) 


same => n,GoSub(subAviso,inicio,1($1 
MSG))) 


. Luego, si en una sentencia 
de la cadena original. 
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En la aplicación Return(), agregamos el 
contenido de la variable DIALSTATUS como 
valor de retorno; esto se hace poniendo este 
valor entre los paréntesis de la llamada. 
Este valor se almacenará en una variable de 
canal especial, definida en Asterisk para este 
fin: GOSUB_RETVAL. Cuando se llama a la 
extensión 701, se invoca la subrutina subDial, 
y si no se obtiene respuesta del remoto, esta 
regresa y devuelve el estado del terminal 
remoto en la variable GOSUB_RETVAL. 


La lógica es similar al ejemplo anterior, pero en 
este caso agregamos una prueba del valor de la 
variable GOSUB_RETVAL con la aplicación IF(). Si 
el valor de la variable es BUSY, entonces la variable 
MSG tomará los valores ocupado O nodisp. 
Estos son los nombres de los archivos de sonido 
que serán reproducidos en cada caso, lo cual se 
observa en la última línea de la extensión 701. Allí 
se realiza la llamada a la subrutina subAviso, 
pasándole como argumento el nombre del archivo 
por reproducir en ARG1, que corresponderá al valor 
de la variable MSG, posicionada en la segunda 
línea del código principal del Dialplan de ejemplo. 


Es importante destacar que este es un ejemplo 
clásico empleado para mostrar el potencial 


O CANALES LOCALES 


que posee esta estructura, y al igual que en 
otros lenguajes, facilita la construcción de 
programas, la lectura, el mantenimiento y la 
reutilización de código, y hace más compacto 
al código resultante. 


Operadores 
y expresiones 


Como muchos otros lenguajes de programación, 
Asterisk incluye operadores, que son un 
conjunto de simbolos conectores especiales 
para manipular variables. Los tipos principales 
de operadores son: 


-Booleanos: evalúan - si 
verdadera o falsa. Estos son: 


la expresión es 


e |: se emplea para la operación OR (0) 
e 4: se utiliza para la operación AND (y) 
e > mayor que 

e <: menor que 

e =: igual a 

e >=: mayor o igual a 

e <=: menor o igual a 

e != distinto de 





Al discar de manera simultánea varios canales con distintos parámetros, una 
forma de incorporarlos desde una única llamada a la aplicación DIAL() es a través 


del tipo de canal Local. 
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-Matemáticos: realizan las operaciones de 
suma (+), resta (-), multiplicación (*), división 
(/) y porcentaje (%). 


la operación de división y, por último, verificará 
si es mayor o igual que 50. Si lo es, la evaluación 
de la expresión dará como resultado True; en 
caso contrario, dará False. 

Las expresiones son conjuntos de variables, 
operadores y valores que, evaluados en 
conjunto, devuelven un valor o resultado de 
la expresión. En el Dialplan estas expresiones 
tienen la siguiente sintaxis: 


Funciones 


Asterisk contiene una estructura especial 
llamada función, que permite realizar cálculos 
con las expresiones y valores. La sintaxis de las 
funciones es: 


$[expresión] 


Cuando el parser del Dialplan encuentra una 
expresión, la evalúa y reemplaza el símbolo 
por el valor. Para la evaluación de la expresión, 
primero sustituye las variables por su contenido 
y, después, realiza las operaciones indicadas 
por los operadores involucrados. Por ejemplo, 
consideremos el siguiente caso: 


NOMBRE_de_FUNCION(argumento) 


Desde el punto de vista de la referencia, se 
la invoca como a una variable, y de la misma 
manera, a su valor: 


S$[NOMBRE_de_FUNCION(argumento)) 
$[S(fcLlamadas) / $(nUsuarios)>=50] 
Por ejemplo, la función LEN() permite calcular 
la longitud de la cadena de caracteres del 
argumento. Para conocer la lista de funciones 


Asterisk reemplazará las variables cLlamadas y 
nUsuarios por sus contenidos; luego, realizará 


RedUSERS?: 81 


>; Programación de Asterisk ll 


> 
AA 
> SÓSIS 
ESTE 
SS SISSI > 





Invercasze lelters 
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disponibles, podemos ingresar, en el prompt 
de Asterisk, el comando: 


CLI> core show functions 


Saltos 
condicionales 


Así como en otros lenguajes contamos 
con algunas instrucciones para realizar un 
redireccionamiento del flujo del programa de 
acuerdo con el valor que arroje la evaluación 
de alguna condición, en esta aplicación 
disponemos de saltos condicionales, que 
explicaremos a continuación. 


APLICACIÓN GOTOIF() 

Asterisk dispone de la aplicación GotoIf(), 
que realiza un salto a un lugar indicado del 
Dialplan siempre que la condición evaluada 
sea verdadera (True). Veamos, en principio, la 
sintaxis que emplea: 
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Si la evaluación de la expresión da un valor 
verdadero (cualquier valor distinto de O o una 
cadena vacía d), el flujo del programa es dirigido 
hacia el punto identificado como destinol; 
en caso contrario, será redirigido al punto 
identificado como destino?. 


Los identificadores de destino se componen de 
hasta tres elementos, y pueden ser: 


e Una etiqueta de prioridad dentro de la mis- 
ma extensión. 

e Una extensión más una etiqueta de prioridad 
dentro del mismo contexto. 

e Un contexto más una extensión más una eti- 
queta de prioridad dentro del Dialplan. 


exten =>  555,Gotolf($[$(nCalls) = 
20]?limite:credito) 
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. GNU nano 2.2.6 File: r/etcrasteriskrsextenslions.conf 
Figura 6. Esta 
exlen ? _XXXX*X*,1,Gotoloutbound-freeninZ, ,S1iEXTENT,1) 
: NS exten >  XXXXX»X*,1, ,Gotofloutbound-freecnun2,S1EXTEN>,1) 
aplicación es exten => _XXXXXXX1,1,Gotofloutbound-freenunZ.S5(1EXTEN),1) 
muy poderosa [foutbound-freenunZ] 
; Thiz is the handler uhich performs the dialing logic. 1t is called 
y puede ser ¿ fron the floutbound-frecnun] context 
: exten => X!?,1,Verboset2,Perforning ISN lookup for S1EXTEN)) 
muy compleja. sane => ¿Set (SUFF IX=S(CUTCEXTEN,+,2-3)) : make 5 
[ 
Notemos las : filtes 
, sane => ¿SEt(TIMEDUT(absolute)=10000) 
diferentes partes sane > n,SelCisnresu lt S1ENUALOOKUPCOS1EXTENT, sip, 1 f reenun.org)))  perfoó 
A EE O 
: : sane => ¿Set (DIALSTATUS=CONGESTIOM) 
de su sintaxis. 2 . : 


sane > ¿Gotolfn-CUNGESTIUN, 1) 


sane >> nUfron),Set(__SIPFROMUSER -SICALLERID (nun) +) 
sane >» n,Gotolf (5["SIGLOBALCFREENUMDOMN INF)" = ""I?dial) ; checkó$ 
sane => n,Set(__SIPFROMDOMA IN=5 (GLODAL (FREENUMDOMA 1N))) 


ifó 





"CRASAIT OMA ARI TIS VEIA KM CMT 
Exit TES AUT Vhere Is Next Page TIAS TINTE 


same => n(limite),Playback(se-acabo- Cuando se llama a la extensión 555, se 

el-credito.wav) evalúa el valor de la variable nCal1s, y si este 
ha alcanzado el número 20, se saltará a la 

same => n,Hangup() etiqueta de prioridad/secuencia identificada 
como limite; en caso contrario, lo hará a la 

same => n(credito),Playback(tiene-cre- etiqueta de prioridad credito. 

dito.wav) 


Si omitimos ingresar el destino etiquetado 
same => n,Hangup() como limite, el programa funcionará igual, 
porque la próxima secuencia es, justamente, la 

que está etiquetada como limite. 


En este ejemplo tenemos dos ramas definidas IMPLEMENTACIÓN DE LAZOS 

y terminadas por la aplicación Hangup(), Veremos un ejemplo donde combinamos 
luego de reproducir un mensaje acerca del las aplicaciones Gotolf() y Goto() para 
crédito para hacer llamadas. construir lazos de ejecución: 


O SALTOS DE EJECUCIÓN 


En programación es necesario contar con instrucciones de control del flujograma. Dos 
de las más empleadas son los saltos condicionales, que deciden sobre la evaluación 
de una condición, y los saltos incondicionales, que no requieren de este paso previo. 
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exten => 555,1,Set(nCal1s=20) 


same => n(entrada),Gotolf($[$fnCalls) 
I= 072:SinCredito) 


same => n,SayNumber($(nCal1s)) 
same => n,Set(COUNT=$[$fnCal1s) - 1]) 
same => n,Goto(entrada) 


same => n(SinCredito),Hangup() 


Cuando se llama a la extensión 555, primero 
se establece el valor 20 para la variable 
nCal1s. En la siguiente secuencia, se evalúa 
si el valor de esta variable es distinto de 0; en 
caso afirmativo, se continúa con la siguiente 
secuencia, donde empleamos la aplicación 
SayNumber() para reproducir el valor de la 
variable en el terminal telefónico que realiza 
la consulta. A continuación, se decrementa 
el valor de la variable nCalls y se realiza un 


O ASTDB 


salto incondicional a la secuencia identificada 
con la etiqueta de prioridad entrada. 


Cuando el valor de la variable nCal11s llegue a 
0, la evaluación de la condición será False y el 
salto se realizará al punto identificado con la 
etiqueta de prioridad SinCredito, luego de 
lo cual la llamada será desconectada. 


Podemos colocar en una misma secuencia/ 
prioridad dos aplicaciones, que se ejecutarán 
según el orden de izquierda a derecha. 


Debemos destacar que, cuando ponemos solo 
un argumento como destino en un GotolIf(), 
este se refiere a una etiqueta de prioridad, el 
segundo será una extensión, y el tercero le 
sumará un contexto. 


APLICACIÓN GOTOIFTIME() 

Por tratarse de una aplicación que trabaja 
con datos cuya naturaleza involucra al tiem- 
po como una variable muy comprometida, 
Asterisk brinda una aplicación de salto con- 
dicional, que evalúa la fecha o, más precisa- 
mente, el System Time (hora del sistema), para 
decidir qué camino tomar. La sintaxis de esta 
aplicación es la siguiente: 





En la DB de Asterisk, los datos se almacenan agrupándolos en lo que se conoce como fa- 
MEE NET E fee o E E E ET: EE UT TEEN y 


dentro de cada familia de datos. 





84 


RedUSERS: 





GotolfTime(hora,dia_de_la_ 
semana,día_del_mes,mes?etiqueta) 


Esta aplicación encamina el flujo del programa 
hacia el punto identificado como etiqueta, 
si los argumentos suministrados coinciden con 
la fecha y la hora actuales, obtenidas desde 
el reloj del sistema. Veamos un ejemplo de 
su uso para comprender mejor la forma que 
tomarán los argumentos: 


exten => entrada,1,GotolfTime(*,*,1, 
jan?cerrado,inicio,1l) 


same => n,GotolfTime(09:00-17:59,mon- 
fri,*,*?abierto,inicio,1l) 


same => n,GotolfTime(09:00- 
11:59,sat,*,*?abierto,inicio,1l) 


same => n,Goto(cerrado,inicio,1) 


La primera secuencia de la extensión entrada 
contiene una llamada GotoIfTime(), donde 





el arreglo de argumentos se lee de la siguiente 
manera: “cualquier hora de cualquier día de 
la semana, el primer día del mes (los días 
se numeran del 1 al 31, y se puede usar el 
operador 8 para días no contiguos), en el mes 
de enero”. 


Si esto es cierto, se produce un salto a la primera 
secuencia de la extensión inicio dentro del 
contexto [cerrado]. Si la evaluación resulta 
falsa, entonces se continúa con la siguiente 
secuencia, donde se evalúa si estamos entre 
las 09:00 y las 18:00 horas (el día inicia a 
las 0:00 y finaliza a las 23:59) de cualquier 
día hábil (lunes a viernes) de la semana (si 
queremos poner días no contiguos, utilizamos 
el operador 4 entre ellos), en cualquier día 
del mes y cualquier mes del año. Si esto 
es cierto, entonces se saltará a la primera 
secuencia de la extensión inicio, pero del 
contexto [abierto]. Si la evaluación resulta 
falsa, se procede a comprobar si estamos en 
un día sábado, entre las 09:00 y las 12:00 
horas. Si es cierto, se saltará al mismo punto 
del contexto [abierto]; en caso contrario, 
se hará un salto incondicional (Goto()) a la 
primera secuencia de la extensión inicio del 
contexto [cerrado]. 


WIKI 





Se queremos profundizar la información acerca del uso y las opciones del tipo de 


canal 
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structure based on the evaluation of the given time specification. Áfter this 
application completes, the pbx engine vill continue dialplan execution at 

the specified location in the dialplan. If the current time is vithin the 

qiven time specification, the channel vill continue at <labeliftrue>. Othervise 
the channel vill continue at <labeliffalse>. If the label chosen by the 
condition is omitted, no jump is performed, and execution passes to the next 
instruction. If the target jump location is bogus, the same actions would 

be taken as for . Further information on the time specification can 

be found in examples illustrating how to do time-based context includes in 


the dialplan. 


¡0tolfTime(times,weekdays,mdays,months[,timezonel?[labeliftruel[:labeliffalsel) 


labeliftrue 
Continue at <labeliftrue> if the condition is true. Takes the form 


similar to Goto() of [[context,]lextension, priority. 


labeliffalse 
Continue at <labeliffalse> if the condition is false. Takes the form 


Similar to Goto() of [[context,]lJextension, priority. 


GotolIf(), Goto(), IFTIME, TESTTIME 
«CLIO 





Para acceder a la documentación en línea de una aplicación, empleamos el comando 


CLl core show application <nombre-apl>». 


Con esta sencilla aplicación, podemos Las etiquetas de identificación siguen las mismas 
administrar el flujo de atención de las llamadas reglas que en el caso de la aplicación GotolIf(), 
que se hacen en horario laboral o fuera de este. que analizamos en el apartado anterior. 


En este capítulo hemos explorado las aplicaciones que implementan los saltos con- 


dicionales, el procedimiento para manejar el código repetitivo, y algunas otras herra- 
mientas y aplicaciones fundamentales que nos ayudarán a implementar un Dialplan. 
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Capítulo 6 


Aplicaciones 
con Asterisk 
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Introducción 


En todos los ámbitos que involucran la atención 
de clientes o usuarios, la función de recepción 
de llamadas y toma de mensajes es clave para 
mantenernos comunicados. Históricamente, estas 
funciones son realizadas por una o más personas 
que trabajan en el área de recepción y que tienen 
responsabilidad sobre las agendas de una persona 
o grupo, en diferentes departamentos de una 
empresa o institución. 


En este capítulo, veremos algunas aplicaciones 
que facilitan estas funciones y ayudan a mejorar 
la productividad de quienes se desempeñan en 
estas áreas. Incluso, en algunas organizaciones 
de pocos empleados, donde estos desarrollan 
múltiples tareas, estas aplicaciones permiten una 
atención profesional, sin la carga económica para 
la empresa y de trabajo para los empleados que 
significa dedicar personal y horas de labor a ellas. 


Correo de voz 


En primer lugar, veremos una de las aplicaciones 
más utilizadas por todos los sistemas de telefonía: 
el correo de voz o casilla de mensajes. Por 
lo general, dotar a los sistemas comerciales de 
esta herramienta requiere de un presupuesto 
elevado. Asterisk incorpora una aplicación que 
permite implementar esta funcionalidad en 
el Dialplan sin costo adicional (y como es de 
código abierto, esto significa con costo cero). Se 
denomina VoiceMai1() y presenta las siguientes 
características generales: 
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e Saludos preparados por defecto 0 
configurables. 

e Notificación de que un mensaje de voz ha lle- 
gado a través de un correo. Además, presen- 
ta la opción de adjuntar al correo el mensaje 
como un archivo de sonido. Esta integración 
es una característica avanzada. 

e Un terminal puede recibir mensajes de más 
de una casilla de mensajes. 

e Una casilla de mensajes puede recibir mensa- 
jes de más de un terminal telefónico. 

e No hay límites de licencias para la cantidad 
de casillas que se pueden habilitar. 

e Cada casilla está implementada por una sim- 
ple carpeta o directorio para organizar los 
correos. 

e Saludos diferentes para los estados no-dispo- 
nible y ocupado. 

e Capacidad de reenvío de mensajes y difusión. 

e Indicación de mensaje en espera para dife- 
rentes tipos de teléfonos. 

e Capacidad de armar un directorio de em- 
pleados de la compañía para  mejo- 
rar la atención de las llamadas entrantes. 


SECCIONES Y CONFIGURACIÓN 

Al igual que muchas otras aplicaciones, esta 
funcionalidad se configura a través de los 
parámetros incluidos en un archivo llamado 
voicemail.conf, que se encuentra en el 
interior del directorio /etc/asterisk/. Con 
la instalación de Asterisk, se incluye una 
versión de este archivo preconfigurado, que 
requiere de pocos cambios y detalles para 
lograr la implementación de la herramienta en 
nuestros sistemas. 
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Este archivo, como otros que hemos visto, 
presenta algunas secciones identificadas por 
nombres entre corchetes, que analizaremos a 
continuación. 


Sección [general] 

En la sección [general], donde se definen 
las configuraciones globales de la aplicación, 
podemos indicar el formato de los archivos 
de audio que se van a utilizar. Los valores más 
empleados para este parámetro son WAV y 
WAVA49. 


También es posible habilitar, en la integración 
con un sistema de correo, el adjuntado de los 
mensajes de voz como archivos de sonido, 
codificados según lo que definamos en esta 
misma sección. 


Otros parámetros que podemos configurar son 
los que explicamos a continuación: 


e La duración mínima de un mensaje, en segun- 
dos, para que sea grabado. 

e La longitud, en segundos, de los saltos de 
búsqueda de mensajes. Cuando se recuperan 
los mensajes, se puede avanzar o retroceder 





SEGURIDAD | 





presionando las teclas asterisco (*) y numeral 
(4E), respectivamente. 

e La máxima cantidad de intentos de ingreso 
a la casilla. 


Las opciones avanzadas de esta sección, 
además de definirse en forma global, pueden 
configurarse para cada casilla de mensajes; 
de esta manera, tendrán prioridad sobre la 
definición global. 


Aconsejamos revisar estas opciones para ver 
si su valor por defecto entra en conflicto con 
los de la implementación. En general, los 
valores por defecto del archivo voicemail. 
conf son adecuados para la mayoría de las 
instalaciones simples, y solo algunos deberán 
modificarse en instalaciones complejas, 
en especial, aquellos relacionados con la 
seguridad o con un impacto sobre ella. Por 
ejemplo, el parámetro dialout <context», 
que permite a los usuarios llamar desde sus 
casillas de mensajes. 


Sección [Zonemessages] 
La sección [zonemessages] permite estable- 
cer el manejo de los mensajes en relación con 








Asterisk incluye un script para mejorar la seguridad del sistema de mensajería de 
voz, que se encuentra en /contrib/scripts/voicemailpwcheck.py. Para emplearlo, 
hay que moverlo a otro directorio, por ejemplo, /usr/1oca1/bin y habilitar la opción ex- 
ternpasscheck=en el archivo voicemail.conf. 
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su time-zone específico. Por ejemplo, es po- 
sible definir etiquetas para identificar las zo- 
nas de tiempo. 


En el archivo de muestra, que se instaló junto 
con Asterisk, /usr/src/sistema-asterisk/ 
asterisk/1.8/configs/voicemail.conf. 
sample, pueden verse la sintaxis y los detalles 
para usar esta sección. 


Sección [default] 

El contenido principal del archivo de 
configuración está ocupado por la sección de 
los contextos de las casillas de mensajes. Esta 
sección, denominada [default], agrupa las 
definiciones de las casillas de mensajes creadas 
para el sistema de mensajería de voz. 


Las aplicaciones que están relacionadas 
con VoiceMail() buscarán este contexto, a 
menos que se definan otros explícitamente. 
La mayoría de los usos que se hagan de la 
mensajería de voz no requieren segmentar 
las casillas de los usuarios, así que la opción 
por defecto será la seleccionada. 


No necesitaremos hacer modificaciones y 
podremos crear las casillas de mensajes para 


(O vuLniconrerencias 


nuestros usuarios dentro de este contexto. La 
sintaxis para hacerlo es la siguiente: 


mailbox => password  [,FirstName 
LastName [,email addr [,pager addr 
[,options[Joptions] 1 1] 1 ] 


Veamos brevemente el significado de cada 
elemento del comando: 


e mailbox: es el número de la casilla, que, en 
general, se corresponde con el número de ex- 
tensión del terminal asociado. 

e password: es la contraseña numérica que 
debe ingresar al usuario para poder acceder 
a la casilla. 

e FirstName LastName: es el nombre del pro- 
pietario de la casilla de mensajes. 

e email addr: es la dirección de e-mail a la 
cual Asterisk envía las notificaciones. 

e pager addr: es la dirección de correo del pa- 
ger o del móvil del propietario de la casilla, 
donde Asterisk puede enviar una notificación. 

e options: son las opciones por casilla, que 
tienen prioridad sobre las globales. Algunas 
opciones válidas son: attach, servere- 


mail, tz, saycid, review, operator, 
dialout y 


callback, exitcontext. 





En los sistemas PBX tradicionales, la capacidad de realizar multiconferencias entre 
extensiones es muy valorada. En estos casos, habilitar esta característica tiene cos- 


tos muy elevados; en Asterisk, por supuesto, es gratuito. 
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z GNU nano ¿.£¿.6 File: r«etcrasterisk-«voicemail.conf 
Figura 1. 
Mediante la A Poicenail Conf iquralion 
configuración de 
¿ NOTE: sterisk has to edit this file to change a user's passuord. This does 
fetc/asterisk/ A A A Id ES 
¿ configuration Files. nor uhen using realtine static configuration. 
voicemail 2 Do nol use Lhen with this conf iguralion File. 
conf, armamos [general] 
Formats for erilim Voicenail. Hole Lhal uhen using INAP =Llorage For 
el sistema de ¿ wolcemaldl, only the first format specificd 4111 be uzcd. 
¿Fornat=9?£351 luaviS var 
nos fornat=40019 9.1400 
mensajería de : 
NARA IAE: 
VOZ. IS EA ES A A A AI 
IT E AAA AO A AO A E A EA 
"CAT OA AAA reo Page EN Cut Text E Cur Poz 
ld Exit Justify WE AA TA 
Como ejemplo, en el listado siguiente, vemos 800 => 6734,Tio Sam,t.same 


una porción de un contexto del archivo otroContexto.com 

de configuración: 
801 => 1987, JoseIngenieros,j.ingenie- 
roseotroContexto.com,,attach=yes|ma 


xmsg=200|tz=ARG 
[default] 


701 => 25419,Pepe  Totio,p.totioce 


lapropia.org La integración entre el servicio de mensajes de 


voz y el sistema de e-mail requiere establecer 
702 => 21678,Esteban Quito,e.quitoe el correo electrónico en la plataforma Linux 


lapropia.org sobre la que se ejecuta Asterisk. 


[otroContexto] A continuación, veremos en profundidad 
las aplicaciones que brinda Asterisk, para 


AAA 
SEGURIDAD |! 


Asterisk, por defecto, no realiza la validación de contraseñas en la aplicación de 
VoiceMail (casilla de mensajes). Si lo deseamos, podemos configurar esta aplicación 
para que le pase el requerimiento a un sistema externo. 
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dexten-HIAASMER ¿n Retural ) 
lextem-HUSY nm, Hedurad d 


A AS AAA EAS AAA 
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Writedui EE File j 
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implementar el servicio de mensajería de voz 
en el Dialplan. 


APLICACIÓN VOICEMAIL() 
La sintaxis de esta aplicación, tal como la utiliza- 
remos en el Dialplan, es la siguiente: 


VoiceMail(mailbox[Econtext][4mail- 
box[econtext][4...]]1[,options]) 


A la llamada debemos pasarle dos argumen- 
tos: la dirección de la casilla para almacenar el 
mensaje y un lista de opciones que detallamos 
a continuación: 


e b: se utiliza para indicar el mensaje de termi- 
nal ocupado. 

e d([C]): acepta dígitos para ser procesados en 
el contexto [C]. Si no se especifica el contex- 
to, utiliza [default]. 

e g(í): solo para canales DAHDI, indica la ga- 
nancia en decibeles que se aplicará al audio 
durante la grabación del mensaje. 

e s: para suprimir las instrucciones que se dan 
por defecto, después de reproducir el saludo. 
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Figura 2. 

El Dialplan 
preconfigurado 
muestra 
ejemplos de 
llamadas a esta 
aplicación. 


e y: se utiliza para indicar el mensaje de termi- 
nal no disponible. Este es el comportamien- 
to por defecto. 

e U: indica que el mensaje debe ser marca- 
do como urgente cuando se pasa una noti- 
ficación por correo o para informar este es- 
tado cuando el usuario llama para recuperar 
sus mensajes. 

e p: establece que el mensaje debe ser marca- 
do como prioritario. 


Como ejemplo, la siguiente porción de Dialplan 
muestra el uso de esta aplicación: 


exten => 903,1,Dial($(Pepe),20) 


same => n,Gotolf($[“S$[DIALSTATUS)” = 
“BUSY”1]?o0cupado:nodisp) 


same => 
default,u) 


n(nodisp),VoiceMai1(9030 


same => n,Hangup() 
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same =>  n(ocupado),VoiceMail(9030 /var/spool/asterisk/ 
default,b) voicemail/<contexto> 

/<casilla_mensajes»>. 
same => n,Hangup() 


Estructura del sistema de mensajes de voz: 


. /INBOX 
Cuando se llama a la extensión 903, 
el Dialplan cursa una llamada al canal ./INBOX/msg0001.WAV 
identificado con el contenido de la variable 
Pepe. Alerta durante 20 segundos y, si no . /INBOX/msg0001.txt 
obtiene respuesta, realiza una evaluación 
del valor de la variable DIALSTATUS. Si este ./INBOX/msg0002.WAV 
es BUSY, salta a la línea identificada con 
la etiqueta ocupado, redirige la llamada a . /INBOX/msg0002.txt 
la casilla de mensajes correspondiente al 


usuario llamado y reproduce un mensaje de ./01d 

ocupado. En caso contrario, continúa con 

la siguiente secuencia identificada como ./01d/msg0000.WAV 
nodisp, redirige la llamada a la casilla de 

mensajes correspondiente al usuario llamado ./01d/msg0000.txt 


y reproduce un mensaje de no disponible. 

./ocupado.WAV 
Los mensajes, por defecto, son almacenados en 
el sistema de archivos de Linux, en el directorio: ./nodisp.WAV 


Figura 3. La 
instalación de 
Asterisk arma 
esta estructura 
para almacenar 
los mensajes 
de voz. 
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Vemos dos mensajes nuevos en la carpeta 
INBOX, un mensaje guardado en la carpeta 
01d, y los archivos de sonido con los avisos de 
ocupado y no disponible en formato WAV. 


APLICACIÓN VOICEMAILMAIN() 

Como sabemos, VoiceMail() permite dejar 
mensajes para los usuarios que no pueden 
o no quieren tomar las llamadas en tiempo 
real. Para cuando estos usuarios deseen 
escuchar los mensajes que les han dejado en 
sus casillas, Asterisk dispone de la aplicación 
VoiceMailMain(). Esta permite recuperar 
los mensajes, grabar saludos y modificar las 
opciones del servicio para quien lo solicite. Su 
sintaxis es la siguiente: 


O UNIFIED MESSAGING 





Figura 4. 

Otro ejemplo 
del archivo 
preconfigurado. 


VoiceMailMain([mai1box][Econtext] 
[,options]) 


Los argumentos son opcionales, pero si no se 
indica una dirección de casilla, se desplegará una 
solicitud para ingresar su número. En la siguiente 
lista mostramos los valores de las opciones. 


e g(¿F): aumenta la ganancia en decibeles para 
la reproducción de los mensajes. 

e p: permite utilizar el parámetro [mailbox] 
como un prefijo del número de casilla. 

e s: evita la confirmación de contraseña. 

e a(carpeta): inicia la sesión en una de las si- 
guientes carpetas del sistema de mensajes de 
vOz: INBOX, 01d, Work, Family, Friends, 
Cust1, Cust2, Cust3, Cust4, Custb. 





Cuando VoiceMail está integrado al e-mail, el conjunto se denomina mensajería uni- 
ficada. En sistemas tradicionales, su implementación es costosa. Asterisk lo resuel- 


ve con un gateway entre el VoiceMail y el e-mail a través de un servidor IMAP. 
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APLICACIÓN DIRECTORY( 

la aplicación Directory() emplea los 
nombres de las casillas de mensajes definidas 
en el archivo voicemail.conf para armar 
un directorio que les permitirá a los usuarios 
realizar un discado por nombre. 


Su sintaxis es la siguiente: 


Directory(contexto_ 
nombres,contexto_dial,opciones) 


El primer argumento indica el contexto del 
sistema de mensajes, y el segundo, el contexto 
del Dialplan al cual pasar la llamada. 


En la porción de Dialplan siguiente, vemos un 
ejemplo de uso de esta aplicación: 


exten => 0,1,Directory(default,inte 
rnos,f) 
exten => 


5,1,Directory(default,internos) 


O ÓRGANOS DE CONTROL 


Si los usuarios digitan el 0, se les presentará 
un directorio de apellidos; y si digitan el 5, uno 
con los nombres. Esta diferencia se indica con 
la opción f como tercer argumento. El nombre 
y el apellido están definidos en el archivo 
voicemail.conf, en la sección [default]. 
Una vez realizada la selección, la llamada se 
enviará al contexto [internos] del Dialplan. 


CALIDAD DEL SONIDO 

El sonido digitalizado se envía por las redes, junto 
con todos los otros tipos de datos, para alcanzar 
el servidor de mensajes de voz. Los datos de 
sonido tienen una naturaleza particular porque 
es información en tiempo real. Esto significa 
que perder un paquete con esta información 
tiene un efecto negativo sobre la calidad de 
la comunicación que se pretende establecer. 
En el caso del servicio de mensajes de voz, los 
mensajes quedarían entrecortados, ininteligibles 
o, directamente, perdidos. El factor determinante 
para que esto suceda es la variación en la 
latencia, más conocida como jitter de las redes 
de datos. Para contrarrestar este comportamiento 
natural de las redes de datos, Asterisk posee una 
opción que entra en funcionamiento al utilizar 
la aplicación. En la siguiente porción de código 
mostramos su uso: 


En la Argentina, los órganos de gobierno de las comunicaciones son la Secretaría 
de Comunicaciones, autoridad de aplicación de las políticas de comunicaciones; y la 
Comisión Nacional de Comunicaciones, encargada del control de dichas políticas. 
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[Servicios] 


exten =>  ¿H40,1,Dial(Local/mensavoze 
Servicios/nj) 


exten => mensavoz,1,VoiceMailMain() 


La opción j, empleada en la llamada a un 
canal local, habilita un buffer de jitter entre 
el llamante y el servicio de mensajes de voz. 
Este buffer puede solucionar el problema 
que se presenta cuando uno o más paquetes 
con información de sonido llegan fuera de 
secuencia, se pierden o no llegan a tiempo, 
rellenando los espacios vacíos y acomodando el 
stream de sonido para que el almacenamiento 
o la reproducción tengan la calidad adecuada. 
La opción n permite indicar que la optimización 
no se realice fuera del camino de esta llamada. 


Esta implementación es necesaria porque 


esta característica (conocida en inglés como 
Jitterbuffer) solo es soportada en el bridge entre 


O SERVIDOR DE VOICEMAIL 


dos canales. Como en el sistema de mensajes 
de voz solo tenemos un canal conectado a las 
aplicaciones, debemos pasar por un canal local 
para cumplir con este requerimiento. 


Menús con 
Asterisk 


Combinando otras aplicaciones que proporciona 
Asterisk, podemos construir sencillos menús 
que orientarán a la persona que llama para 
que encuentre lo que busca, y a nosotros nos 
permitirá mejorar el servicio. 


En el ejemplo que presentamos a continuación, 


vemos una simple implementación de un menú 
con tres posibilidades: 


[Menu-1] 


exten => 89,1,Answer() 


same => n,Background(principal) 





En una implementación tradicional, el sistema de VoiceMail suele atenderse con un 
servidor dedicado a este servicio. Asterisk es capaz de funcionar como un sistema 
dedicado a ser servidor de VoiceMail para ser incorporado en las instalaciones de 


PBX propietarias. 
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same => n,WaitExten(10) 
exten => 1,1,Playback(sonidos/1) 
exten => 2,1,Playback(sonidos/2) 


exten => 3,1,Hangout() 


En el contexto [Menu-1] de esta porción del 
Dialplan, hemos utilizado dos nuevas aplicaciones: 
Background() y WaitExten(). La primera ope- 
ra en forma similar a Playback(), empleada en 
otros ejemplos. La diferencia es que si la persona 
que llama introduce algún dígito mientras se está 
reproduciendo el mensaje, que le hemos pasado 
como argumento a la aplicación, esta detiene la 
reproducción y le pasa la llamada a la extensión 
indicada. En nuestro ejemplo, al llamar a la exten- 
sión 89, se reproducirá el mensaje grabado en el 
archivo principal, donde se informarán las op- 
ciones posibles, mientras se esperan dígitos DTMF 
(son los sonidos que se escuchan cuando presio- 
namos los números en un teclado telefónico) en 
Background. Si estos no llegan y deseamos dar- 
le tiempo al usuario para que ingrese su selección, 





GRABACIÓN DE MENSAJES 





una vez terminada la reproducción (puede suce- 
der que el usuario necesite la última opción gra- 
bada en el aviso), podemos emplear la segunda 
aplicación mencionada, a la que le pasamos como 
argumento el tiempo en segundos que deseamos 
aguardar (en este caso, 10 segundos) antes de 
continuar con la siguiente secuencia. 


En este menú de tres opciones, las dos primeras 
conducen a la reproducción de los números 
marcados (sus sonidos están grabados en archivos 
cuyo nombre es el número correspondiente en 
el directorio /sonidos dentro del directorio por 
defecto donde Asterisk guarda los sonidos) y la 
tercera, al corte de la comunicación. Si se ingresa 
cualquier otro número, el Dialplan no sabrá cómo 
proceder. Por eso, es importante planear las 
posibles ramificaciones antes de implementar esta 
característica. 


Asterisk define algunas extensiones especiales 
para el manejo de situaciones excepcionales, 
como el tratamiento de información no válida 
cuando se espera por ella para realizar alguna 
acción en particular, como en nuestro ejemplo. 
Para estos casos, está definida la extensión 
identificada con la letra 1, donde Asterisk, en 








La aplicación Record() toma como argumento el nombre de archivo con su 
extensión, porque permite grabar en diferentes formatos. La aplicación Playback() 
no requiere la extensión porque selecciona el mejor formato en términos de 


consumo de recursos de CPU. 
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vez de cancelarla, dirige la llamada a dicha 
extensión si los dígitos que se han ingresado no 
corresponden a ninguna extensión válida en el 
contexto considerado. 

Otra extensión es la definida con la letra t, que 
se emplea cuando se ha superado el tiempo 
de espera del ingreso de dígitos por parte del 


usuario. El ejemplo siguiente muestra el uso de 
estas extensiones: 


[Menu-1] 

exten => 89,1,Answer() 

same => n,Background(principal) 
same => n,WaitExten(10) 

exten => 1,1,Playback(sonidos/1) 


exten => 2,1,Playback(sonidos/2) 


: sample Lall Features 


DOTA 


AA A 


exten => 3,1,Hangout() 
exten=>1,1,Playback(entrada-invalida) 


exten => 
t,1,Playback(supero-el-tiempo) 


same => n,Hangup() 


Call 
parking 


Esta funcionalidad se utiliza para poner en 
espera una llamada o para estacionarla 
de modo que pueda ser tomada desde otra 
extensión. Permite dotar al sistema de la 
capacidad de transferencia de llamadas entre 
internos. Su comportamiento se define en 
el archivo features.conf. Los parámetros 
más importantes, configurados en la sección 
[general] de este archivo, son los siguientes: 


Eon -yE 1 + E rl ib E repita == a a ña 
A AS ES * Speclóy A A A ] A E 


¿Bl ony access this parking 


A O Isela p A A 


y lr 
E Get Help El dritesdat isa File TN E 
Ex 11 ustifa here [x= Hext Fago 
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(deramit 15 Figura 5. Los 
archivos *.CONF 
tienen información 
de configuración. 
Aquí vemos el de la 
funcionalidad Cal1 


Parking. 
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e parktest: es el nombre de la extensión en la 
que se estacionan las llamadas. Al transferir la 
llamada a esta extensión, el sistema le dirá en 
qué posición está. El valor por defecto es 700. 

e parkpos: define el número de ranuras de que 
dispone el sistema para alojar llamadas. Por 
ejemplo, para definir treinta posiciones, debe- 
mos configurar este parámetro en 701-730 . 

e context: indica el nombre del contexto de 
estacionamiento de llamadas. 

e parkingtime: indica el tiempo, en se- 
gundos, que la llamada puede estar esta- 
cionada. Si no se responde antes de este 
tiempo, el sistema devuelve la llamada a 
la extensión que la puso en ese estado. 


Veamos un ejemplo de uso de esta característica: 


[internos] 
include => parkedcalls 
exten 


=> 404,1,Dial(SIP/Carlos,,tT) 


exten => 405,1,Dial(SIP/Silvia,,tT) 


O MENSAJES EN VOICEMAIL 


Un usuario llama a la extensión 401 para ha- 
blar con Carlos, quien luego de un tiempo, ne- 
cesita pasarle la llamada a Silvia para que 
complete la solución del problema que tiene el 
usuario. Carlos transfiere la llamada a la ex- 
tensión 700 y recibe un mensaje que le dice 
que la llamada ha sido estacionada en la ex- 
tensión 710. Carlos llama ahora a Silvia a la 
extensión 405 y le avisa que tiene una llamada 
en espera del usuario en la extensión 710; en- 
tonces Silvia llama a la extensión 710 y ha- 
bla con el usuario. El usuario estuvo hablando 
con Carlos, quien le dijo que lo transferiría a 
una compañera que seguiría con su caso; luego, 
fue puesto en espera y, finalmente, fue atendido 
por Silvia, con quien continuó la conversación. 


Atención 
automatizada 


“Si quiere enviar un fax, presione uno, si quiere 
hablar con ventas presione dos, o espere y será 
atendido...”. Una de las herramientas más 
comunes que poseen las implementaciones 


de sistemas de telefonía en general es la 


Asterisk crea un archivo por cada mensaje que se deja en el sistema de VoiceMail. 
El nombre del archivo es MSGNNNN.TXT (donde NNNN es un número de cuatro cifras); 
contiene información de contexto del mensaje y se utiliza para manejar la indicación 


de mensaje en espera. 
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denominada  autoatendedor. Con esta 
funcionalidad nos encontramos al llamar 
a una empresa: un autómata que nos guía 
por numerosas opciones de un menú hasta 
encontrar lo que queremos. 


Un sistema de atención automática presentará 
las siguientes características generales: 


e Posibilidad de transferir a una extensión. 

e Posibilidad de dejar un mensaje de voz. 

e Posibilidad de transferir la llamada a una cola 
de espera. 

e Reproducción de mensajes. 

e Conexión con otros menús. 

e Conexión con la recepción o desborde final. 

e Repetición de las opciones. 


Si bien estas características son algunas 
de las que ya hemos explicado durante la 
implementación de Asterisk, una de las 
cuestiones fundamentales de un sistema de 
autoatención pasa por su diseño. 


También es importante aclarar que no 
debemos confundir esta función con otra muy 
difundida y empleada, el IVR (Interactive 
Voice Response). La autoatención es parte del 


O HISTORIA DE LA TELEFONÍA 





IVR, pero no es un IVR. Un IVR tiene un diseño 
más complejo y costoso, e involucra accesos 
a aplicaciones del backoffice, especialmente, a 
bases de datos. Con Asterisk también podemos 
implementar un IVR, pero este es un tema que 
queda fuera del alcance de este libro. 


CONSIDERACIONES DE DISEÑO 

Al diseñar un sistema de autoatención (AA), 
es importante tener en mente que este será 
utilizado por clientes/usuarios, y no solo debe 
conformar las expectativas técnicas y estéticas 
del implementador. No podemos olvidar que 
las personas llaman por teléfono para hablar 
con un ser humano y, en general, toleran 
estos sistemas porque no tienen opción. Por 
eso, una buena práctica es incluir la opción 
de transferir la llamada a un representante 
en algún punto del árbol, cercano al ingreso; 
por ejemplo, luego de pasar por las opciones 
más empleadas. Si estas son muchas, algunos 
clientes abandonarán la empresa y, si hay 
competencia, quizá no vuelvan a llamar. 
Entonces, otra buena práctica es que el 
sistema sea lo más simple posible. 


No pretendemos ser exhaustivos en las 
consideraciones, pero podemos sugerir una 


Por el año 1854, el inventor italiano Antonio Meucci construyó un teléfono para 
comunicarse con su esposa, que, enferma, estaba postrada en la planta alta de su 


casa, en Nueva York. Como no tenía dinero suficiente, no pudo patentar su invento. 
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lista de los elementos que no pueden faltar en 
un sistema de autoatención: 


e Transferencia a un operador humano. 

e Saludos de acuerdo con la hora del día. 

e Agradecimientos. 

e Presentación de la compañía. 

e Avisos con horarios de atención y cierre. 

e Permitir la llamada a un interno, si este es 
conocido. 

e Listado de extensiones de los departamen- 
tos clave (ventas, contaduría, etc.). 

e Acceso a servicios como directorio de la em- 
presa, envío de fax, etc. 

e Música en espera con variaciones. 

e Mensajes de publicidad de los productos de 
la compañía o de la compañía misma. 

e Habilitar el retorno para escuchar las 
opciones. 

e Permitir la recepción de mensajes de voz 
para el destino, si este se encuentra ocupado. 

e Reproducción de mensajes de  cor- 
tesía (ocupado, no disponible,  etc.). 


Si bien los saludos pueden cambiar según 
la hora del día o el día de la semana, 
no modifican la estructura del menú. También 
debemos saber que si se saluda al acceder 





al sistema y se retorna a escuchar las opciones, 
es más elegante no volver a reproducir 
los mensajes. 


Cuando planeamos las opciones, tenemos 
que considerar que las personas no ponen 
mucha atención a lo que se dice, sino que 
están esperando conocer qué número deben 
presionar; por eso, es aconsejable informar 
primero el destino y después el número. Por 
ejemplo: “Para comunicarse con planta, 
presione 4”. 


Además, las opciones más importantes desde 
el punto de vista de quien llama deben estar 
al principio del árbol. Por ejemplo, si existe un 
directorio, podemos incluirlo al comienzo de la 
grabación para darlo a conocer al público, y 
dar las opciones de transferencia al informar 
las extensiones clave de la compañía. 


Otro tema para considerar es el tratamiento de 
las entradas inválidas y los tiempos de espera 
excesiva o timeouts del sistema. 


Una vez que finalizamos el diseño, podemos 
realizar su implementación en el Dialplan. 
Antes de escribir el código, necesitamos unos 


COMPATIBILIDAD 


Asterisk soporta el protocolo ( 


), que permite 


la interoperabilidad entre sistemas de telefonía y sistemas de VoiceMail. Como es 
dependiente de las implementaciones propietarias, requiere cuidado al usarlo. 
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componentes esenciales que serán empleados 
al momento de programar la lógica. Estos 
elementos, denominados prompts, son los 
mensajes que utilizaremos en el sistema de 
autoatención. 


PROMPTS 

Los mensajes que vamos a utilizar en el sistema 
de autoatención son de vital importancia, porque 
serán la imagen de la empresa ante los usuarios 
que llamen. Es decir, es el primer contacto que 
tendrán los usuarios con la empresa. 


El formato preferido para grabarlos es WAV, y 
la única combinación que funciona en Asterisk, 
hasta ahora, es monoaural, en 16 bits y 8 KHz. 


Si bien podemos grabar los mensajes en 
estudio o con algún software como Audacity, 
la manera más directa y sencilla de hacerlo 
es utilizando la aplicación  Record() de 
Asterisk. En el siguiente ejemplo, explicamos su 
funcionamiento: 


[grabador] 


DD) BUENA PRÁCTICA 


exten => 
665,1,Playback(inicio-grabacion) 


exten => 665,n,Record(saludo-uno.wav) 
exten => 665,n,Wait(2) 
exten => 665,n,Playback(saludo-uno) 


exten => 665,n,Hangup 


Cuando se llama a la extensión 665, este 
código reproduce un mensaje que alerta 
sobre el inicio del período de grabación; 
luego, graba un mensaje en formato WAV; al 
finalizar (por tiempo), espera 2 segundos y 
procede a repetir el mensaje recién grabado. 
Después, termina la llamada. 


IMPLEMENTACIÓN EN EL DIALPLAN 

A continuación, presentamos un ejemplo de 
aplicación de un sistema de autoatención que 
sigue los parámetros explicados anteriormente: 


[Menu_Principal] 


Asterisk puede manejar el hecho de que un número de opción se solape con el de 





una extensión, pero esto genera una demora al esperar el lapso de tiempo de guarda 


del interdígito, antes de proceder. Por eso, aconsejamos utilizar extensiones con 


diferentes números que las opciones. 
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Figura 6. En 


este archivo se 


File: «eteranterlsk-gueues. cur 


implementan 
las colas de 
espera. 


exten => s,1,Answer() 


exten => 1,Goto(Filas,9001,1) 


same => n,Set(TIMEOUT(digit)=2) exten => 2,Go0to(Filas,9002,1) 


same => n,Wait(1) exten => 3,Background(dire_fax) 


same => n,GotolfTime(9:00-17:00,mon- exten => n,Goto(s,opciones_menu) 
fri,*,*?laboral:no_laboral) 


exten => ¿,Directory() 
same => n(no_ 
laboral),Background(fuera_horario) 


exten => 0,Dial(SIP/operador) 


same => n,Goto(opciones_menu) exten => ¡,Playback(entrada-invalida) 


same => same 


=> 1,Goto(s,opciones_menu) 
n(laboral),Background(en_horario) 


same => t,Goto(0,1) 
same => n,Goto(opciones_menu) 


exten => _1XX,1,Verbose(1, LLamar a 


una extensión que inicia con “1?) 


same => nlopciones_ 


menu), ,Background(menu_principal) 


same => n,Goto(Internos,$fEXTEN),1) 
same => n,WaitExten(3) 


Antes de cada selección, es posible agregar 
same => n,Goto(0,1) alguna locución orientativa. Por cuestiones de 
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legibilidad, hemos preferido no sobrecargar 
el código, por eso evitamos incorporar estas 
líneas, que puede generar confusión. 


la mayoría de las aplicaciones que se 
emplean en esta porción de Dialplan fueron 
estudiadas en secciones y capítulos anteriores. 
Recordamos que la aplicación llamada 
Wait(T) permite incluir una demora en 
segundos igual a su argumento T. 


A continuación, veremos brevemente qué 
significa el argumento Filas. Este argumento 
se refiere a una Queue. Las queues son las 
colas de espera que se pueden definir en 
Asterisk para estacionar las llamadas. En este 
caso se han definido, previamente, dos colas 


O COLAS DE ESPERA 





Figura 7. La 
definición 

de una cola 

se inicia con 

su nombre 
encerrado entre 
corchetes ([ 7). 


de espera: una para el área de ventas y otra 
para el área de soporte. El comportamiento 
y la configuración de estas colas se definen 
mediante el archivo queues.conf, y su 
definición en el Diaplan se muestra en la 
siguiente porción de código: 


[Filas] 


exten => 9001,1,Verbose(2,$fCALLERID 
(a11)) ingreso a la fila de soporte) 


same => n,Queue(soporte) 


same => n,Hangup() 





Para obtener más información sobre la configuración y el tratamiento de las queues o 
colas de espera, sugerimos consultar el sitio oficial de Asterisk, www.asterisk.org, o 


la wiki https: //wiki.asterisk.org/wiki/display/AST/Using+queues.conf. 
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exten => 9002,1,Verbose(2,$fCALLERID 
(a11)) ingreso a la fila de ventas) 


same => n,Queue(ventas) 


same => n,Hangup() 


[internos] 
include => Filas 


Excede a los alcances de este libro el desarrollo 
del tema de las filas o colas de espera, pero 
para su comprensión basta saber que, a 
medida que las llamadas van llegando, se van 
estacionando en estas filas. 


Estas tienen una estrategia FIFO (la primera 
que llega es la primera que se atiende), y 
en su configuración se establece el número 
máximo de llamadas que pueden contener 
(lo que usualmente se informa a los usuarios 
con un mensaje que dice: “Todos nuestros 
operadores se encuentran ocupados”). 
la llamada a las filas se realiza invo- 
cando a la aplicación Queues(fila), cuyo 


IVR 





argumento es la fila definida en el archivo 
queues.conf. 


Es muy importante que realicemos diferentes 
pruebas exhaustivas con estas configuraciones 
a los efectos de determinar que, dentro del 
sistema de autoatención, únicamente es 
posible realizar aquellas acciones que han sido 
debidamente planeadas. 


CAMINO DE LAS LLAMADAS 
Las llamadas que ingresan al sistema son 
enviadas al contexto definido, cualquiera sea el 
canal por donde hayan entrado. 


Esto quiere decir que la totalidad de las llama- 
das deben ser dirigidas al sistema de autoaten- 
ción, independientemente del nombre del con- 


texto y del nombre de la extensión que posean. 


En la siguiente línea de código, mostramos una 
manera posible de hacerlo: 


[RTC] 


exten => 





Un sistema de respuesta de voz interactivo es mucho más que un sistema de autoatención. 
Entre otras particularidades, está la integración con una base de datos. Suele confundirse 
con un autómata que atiende en vez de una persona, pero no son lo mismo. 
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41810101,1,1Goto(Menu_Principal,s,1) 


En este ejemplo podemos observar que aquellas 
llamadas que ingresan al número de extensión 
41810101 son dirigidas al menú principal del 
sistema de autoatención. Lo mismo sucedería 
si en este código reemplazamos el número de 
extensión por uno diferente. 


Aplicación 
MeetMe[) 


La aplicación MeetMe () permite que varios 
usuarios formen una conferencia de audio. Sus 
características principales son: 


e Capacidad de crear conferencias protegidas 
con contraseña. 

e Administración de conferencias: eliminar par- 
ticipantes, bloquear conferencias, etc. 

e Creación dinámica y estática de conferencias. 


Para su configuración utilizamos el archivo 
meetme.conf, en el cual podemos definir las 


O VISUALIZAR LAS OPCIONES 


salas de conferencias virtuales y las contraseñas 
de ingreso a ellas, entre otras opciones. 


A continuación, vemos la definición de una sala 
sin contraseña a la que se accede llamando a la 
extensión 500: 

[rooms] 

conf => 500 

Como siempre, cuando modificamos la 
configuración de aplicaciones o parámetros del 
sistema, es necesario recargar Asterisk para que 
pueda volver a leer los archivos de configuración. 
La sintaxis de la aplicación es la siguiente: 


MeetMe(sala,opciones,contraseña) 


Para habilitar esta sala, debemos hacer la 
siguiente configuración en el Dialplan: 


exten => 500,1,MeetMe(500,1,) 





Para visualizar las opciones que pueden utilizarse con una aplicación Asterisk, 
podemos emplear el comando CLl (Core Show Application). Por ejemplo: *CLI> core 


show application MeetMe. 
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Cuando los usuarios llaman a la extensión 500, 
si se ha configurado una contraseña, esta será 
requerida (en el ejemplo no se la solicita) y, 
luego, se los sumará a la conferencia. 


La opción 1 permite que, cuando un usuario 
ingresa a la conferencia, los demás escuchen un 
mensaje de anuncio de su ingreso, virtualizando 
la situación de arribo de una persona a una Sala 
real de conferencia. 


En el ejemplo siguiente, veremos cómo limitar 
la cantidad de participantes que aceptamos en 


: [máarkny 1 


ÉS 
E RT A 


 HMusicclasa sels uhich music applies for this particular call quee. 
¡ The only class uhich can override this one ds 1f the ROH class ds set 


¿directly on the channel using SeL(CLHAANNEL(muisicolass) 


; dialplan. 


imusleclass = default 











GA nano 2.2.6 File: reteraster [slk rectre- conf 


> como, pla adria ind 


A A 
lake effect os 


hen it ls real do fa E 


Licipant has 
CIA 
ko goes Ala. 


this 


Heat 


IT Y Fago 
Ehere E 


una sala, introduciendo el uso de la aplicación 
MeetMeCount(): 


exten => 500,1,MeetMeCount(500,PART 
ICIPANTES) 


same => n,Gotolf($[$(PARTICIPANTES) 
<= 5b]?2ingresa:rebota,1l) 


same=>n(ingresa),MeetMe(500,1,Clave3) 


En 
el archivo 
preconfigurado, 
la sala 1234 
se alcanza al 
llamar a la 
extensión 8600. 


uhaleveri in the 
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exten=>rebota,1,Playback(sala_llena) 


same => n,Hangup() 


En esta porción de Dialplan, cuando se llama 
a la extensión definida para la sala en el 
archivo meetme.conf, mediante la aplicación 
MeetMeCount(), se asigna un valor igual al 


número de participantes en la sala 500 a la 
variable PARTICIPANTES. Esta se emplea 
en la siguiente secuencia para, luego de su 
evaluación, permitir o denegar el ingreso a la 
sala. Si el número de participantes es mayor 
que 5, se le informa al usuario que la sala está 
llena y se corta la llamada. Si es menor, se 
invoca la aplicación MeetMe(), y se le permite 
sumarse a la conferencia. 


Los servicios que en otras plataformas son costosos y complejos de implementar, 


con Asterisk resultan gratuitos y simples. En este capítulo explicamos algunos de los 
servicios clave de cualquier sistema de atención telefónica. 
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=> 





AMI 


Asterisk Managment Interface, también co- 
nocidad por su sigla AMI, es una capa de soft- 
ware que permite monitorear en línea el siste- 
ma Asterisk y manejarlo, para hacerlo realizar 
diferentes acciones. Además, hace posible el 
desarrollo de aplicaciones, utilizando Asterisk 
como plataforma. 


Mediante el archivo manager.conf, que se en- 
cuentra en el directorio /etc/asterisk, pode- 
mos habilitar y configurar esta funcionalidad. El 
listado que presentamos a continuación mues- 
tra los parámetros fundamentales por configu- 
rar y sus valores, para empezar a trabajar con 
esta herramienta: 


[general] 
enabled = yes 


webenabled = yes 


GA nano 2.2.6 File; «elcraslerisk-manaqer. conf 


A O NS A 
¿ You can open a commection to this socket vith e.y. 


port=5038 
bindaddr = 0.0.0.0 
[cuenta] 
secret=clave 


read=system,call,1l0g,verbose,agent,us 
er,config,dtmf,reporting,cdr,dialplan 


write=system,call,agent,user,config,c 
ommand,reporting,originate 


Esta característica no se encuentra habilitada 
por defecto, porque salvo que se precise desa- 
rrollar alguna aplicación que deba comunicarse 
con Asterisk, a nivel de software, no es necesa- 
ria y le pone cierta carga adicional al sistema. 


No es una funcionalidad clave para la tarea de 
Asterisk, sino para su comunicación con otros 
productos o desarrollos de software, en espe- 
cial, los de gestión. 


“enabled” must be set tool. 


z Figura 1. 
E E 

: La API de 
¡Llisenab leona A AE 

= ; address and port to bind to, default $ : 
¿tlecertiles-"teprasterisk.penm : path to the certificate. Asterisk 
¡Lisprivalekeyo-«Laprprivale.pen :; path Lo the privale key, ifono privale qiuen, . 

¿df mo tlsprivatekey ds gluen, default iz to 35 requiere que 


¡tlscipher=<c1pher string> 


A Cect Help Ur itelut 


E Freu Page 
pl 


| Exit AS A ES | Next Page 
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se la habilite 
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GNU nano 2.2.6 File: /etc/asterisk/manager.conf 
Creamos 5 cdr - Output of cdr_manager, if loaded. Read-only. 
5 dialplan - Receive NeuwExten and VarSet events. Read-only. 
una cuenta para ; originate - Permission to originate new calls. Write-only. 
5 agi -— Dutput ÁGI commands executed. Input ÁGI command to execute. 
oder conectar » EE - Call Completion events.  Read-only. 
p 5; aoc -— Permission to send Advice 0f Charge messages and receive Ádvice 
; - Df Charge events. 
con la API. ; test - fbility to read TestEvent notifications sent to the Ásterisk Test 
; A A AA PEE AIN SA A A 
compiler flag is defined. 
¿read = system,call,log,verbose,agent,user,config,dtmf , ,reporting,cdr,dialplan 
¡urite = system,call,agent,user,config,command,reporting,originate 
[cuenta] 
secret = clave 
read = system,call,log,verbose,agent,user,config,dtnmf, reporting, cdr,dialplan 
write = system,call,agent,user,config,command,reporting,originate 
"CRT OI RETO III KA CMA TS 
Exit Justify TS ES Next Page ADA TIAS 
También, necesitamos revisar los valores del ar- biindport=8088 


chivo /etc/asterisk/http.conf para con- 
firmar que sus parámetros tengan los valores Con esto, habremos habilitado el servidor HTTP 


que mostramos a continuación: incluido con el sistema Asterisk. 

[general] Una vez realizadas estas tareas de preparación, 
vamos a confirmar la conectividad con la AMI 

enabled = yes a través de los dos métodos más empleados: 
TCP y HTTP. A continuación, presenta- 

enablestatic=yes mos dos , donde explica- 
mos cada uno de estos procedimientos 

bindaddr = 0.0.0.0 en detalle. Veremos que es algo muy simple. 


GAU nano ¿.Z.6 File: «eterasterlsk-http.conf 
hltpir*iservuer_ips:<bindporls-slalic-docs- index.html 
[genera 1] 


A A EA AA A 
This also affecila manaqer-«raunan-"axal access [see manager.conf ] 


epabled=yes 
. El fddress to blind to, both for HTTP and HTTFS. — Default is 
servidor HTTP bindaddr=0.0.8.8 
incluido en : A IA O TA A 


bindport=8688 


Asterisk se maneja 
desde el archivo / 


enablestalicyes 





etc/asterisk/ CRE CA EROS TESTO FRE CS 
a Exil ba li Mhere ls Next Page Mikal Tex Tu quel | 


ATT. COn. 
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Conexión con AMI a través de TCP 





Conéctese a través del puerto 
5038: df telnet localhost 
5038. A continuación, ejecute 
un login: 


Action: Login 
Username: cuenta 
Secret: clave 
RETURN 

RETURN 


Ahora, ejecute un ping: 
Action: ping 


RETURN 
RETURN 


Para finalizar, ejecute un logoff: 


Action: logoff 
RETURN 
RETURN 





o Red 


AMI 





PASO A PASO /2 


Conexión con AMI a través de HTTP 





La conectividad AMI a través de HTTP permite la integración de llamadas de control 
a Asterisk desde un web service. 


Ingrese el siguiente comando 
para hacer un login: 


iF wget “http:// 
localhost:8088/ 
rawman?action=1l0gin4 
username=cuentadsecret= 
clave” 

--save-cookies cookies. 
txt -0 - 


Ahora, ingrese el siguiente 
comando para realizar un ping: 

iF wget “http:// 
localhost:8088/ 
rawman?action=ping” --load- 
cookies cookies.txt -0 - 


Por último, ingrese el siguiente 
comando para efectuar un logoff: 


dk wget “http://localhost:8088/ 
rawman?action=lo0goff” --load- 
cookies cookies.txt -0 - 
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Respuesta al requerimiento 


Figura 4. Asterisk se reporta al cliente ante eventos del sistema y se le pueden solicitar acciones. 


La conectividad AMI a través de HTTP permite 
la integración de llamadas de control a Asterisk 
desde un web service. 


Dentro del archivo de configuración mana- 
ger.conf, se encuentra la sección [gene- 
ral], donde, como en otras configuraciones, 
ingresamos los valores globales que afectarán 
el funcionamiento de AMI. Las restantes sec- 
ciones son cuentas de usuario con sus contra- 
señas (en el ejemplo hemos configurado una 
cuenta con contraseña para probar la conec- 
tividad) y permisos. También será necesario 


O MÁS SOBRE MANAGER.CONF 


configurar el servidor web incluido en Asterisk, 
para poder realizar conexiones por medio 
de este método. 


PROTOCOLO 

Entre el software cliente y la interfaz AMI de 
Asterisk se establece un diálogo que está re- 
glamentado por un protocolo compuesto por 
dos tipos de mensajes: Manager Events (ME) 
y Manager Actions (MA). 


Los Manager Events son mensajes que viajan 
desde la AMI al cliente y reportan eventos 





Para conocer más sobre las diferentes opciones que se pueden configurar en el ar- 
chivo manager.conf podemos consultar la wiki: https://wiki.asterisk.org/wiki/do- 


searchsite.action?queryString=manager.confíwhere=AST8typ 
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connected 


Figura 5. 


User-Agent: curl/?.27.0 
Host: localhost :8088 
Accept: 


Respuesta de 


A/A 


AMI para la 
codificación HTTP/1.1 200 OK 
Server: 
DAA A 
Connection: 
Cache-Control: 
Content-Length: 
Content-tyupe: 
Cache-Control: 
Set-Cookie: 
Pragma: 


mxm!l. 


close 


se 
H 
y 
> 
> 
> 
> 
y 
< 
< 
< 
< 
< 
< 146 

< text/xml 
< 

< 

< 


SuppressEvents 
Y 

<a jax-response> 
<response type='object' 
tication accepted' 
</a jax-response> 


* Closing connection 0 


HTTP 1.1 or later vith persistent connection, 


no-cache, 


no-cache; 
mansession_id="deafa3f8":; 


id="unknouwn' ><generic response='Success” 
/></response> 








ARA O AAA E 10D) 
GET /mxml?action=loginéusername=cuentaásecret=clave HTTP/1.1 


pipelining supported 


AsteriskySUN—branch-1.8-r381975 
A A AO e E O PAE IS y 


no-store 
Version=1: 


Max-ÁAge=60 


AS A 


usuarioasteriskfubuntu:/etc/asteriskS5 _ 


ocurridos en el sistema. Los Manager Actions son 
mensajes de respuesta que van desde el cliente 
hacia la AMI en Asterisk. El funcionamiento es 
similar, en el concepto, al del protocolo SNMP. 


En la Figura 4 podemos ver la relación entre 
estas dos entidades y los tipos de mensajes que 
viajan entre ellas. 


Cuando empleamos una conexión HTTP con- 
tra la AMI, se presentan dos formas de 


autenticación: 


e Action Login 
e HTTP digest 


O MÁS SOBRE HTTP.CONF 


El primer caso corresponde al ejemplo 
empleado al principio del capítulo. Para el 
segundo método, AMI presenta tres tipos de 
codificación: 


e -/rawman 
e -/manager 
e -/mxml 


En el despliegue del siguiente comando 
podemos apreciar el tipo de codificación /mxml: 


F curl -v “http://localhost:8088/ 
mxm1?action=logingusername=cuentad 
secret=clave” 


Para conocer más sobre las diferentes opciones que se pueden configurar en el ar- 
chivo http.conf podemos consultar la wiki: https://wiki.asterisk.org/wiki/dosearch- 
site.action?queryString=http.confiwhere=AST8étype=8élastModified=8contributor= 


ScontributorUsername=. 
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En el método de conexión HTTP los ME no son 
asincrónicos, como en el método TCP: deben ser 
buscados a través de una consulta que tenemos 


PASO A PASO /3 


que realizar explícitamente a la AMI de Asterisk. 
En el siguiente Paso a Paso vemos un ejemplo 
de este procedimiento: 


MEE RAIN EME ER) 
































Ingrese el siguiente comando para hacer 
un login: 


iF wget 

--save-cookies cookies.txt 
Ww”http://1o0calhost:8088/mxml?act 
ion=loging4username=cuentaégsecret 
=Clave” -0 - 


Ahora, ingrese el siguiente comando 
para efectuar un ping: 


1F wget 

--load-cookies cookies. 

txt “http://localhost:8088/ 
mxml?action=waitevent” -0 - 


En este capítulo exploramos la interfaz de software que ofrece Asterisk para que los 
desarrolladores de aplicaciones puedan dialogar con el sistema. También conocimos 
los principales métodos de conexión: TCP y HTTP. 
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Introducción 


La información que genera un sistema de 
telefonía se utiliza para su mantenimiento, 
la solución de problemas y el análisis de 
dimensionamiento. Pero también contamos 
con información para la facturación y la 
carga de las llamadas realizadas a través del 
sistema, para dar seguimiento y auditoría del 
tráfico cursado, y hacer análisis de llamadas 
para la atención de cuestiones legales, entre 
otras posibilidades. A continuación, veremos 
cómo podemos obtener todos estos datos. 


Monitoreo 


Resulta muy importante conocer el estado 
de salud de los equipos de comunicaciones 
en general, y de las conexiones entre ellos en 
particular. Con esta finalidad, existe el protocolo 
SNMP, que se ejecuta en una consola de 
gestión, y permite obtener una foto del estado 
de la red, tomada a intervalos regulares. 


SNMP es un protocolo muy antiguo que in- 


tegra el conjunto de protocolos TCP/IP, cuya 
función es interrogar al sistema acerca de 


O PLATAFORMA DE GESTIÓN 


determinados parámetros (disponibilidad, an- 
cho de banda consumido, errores en las inter- 
faces, etc.) para que este reporte los eventos 
que suceden en él, Tiene diferentes versiones 
en uso, pero la más reciente es la V3, que po- 
see características de seguridad en la comu- 
nicación entre los agentes SNMP y el servidor 
SNMP, que no contienen las anteriores. 


A continuación, en el Paso a Paso 1, veremos 
el procedimiento para habilitar este protocolo, 
en su versión 2, para que Asterisk pueda usar- 
lo, y nosotros, desde una consola de gestión, 
podamos conocer el estado del sistema. 


Nos concentraremos en habilitar la plataforma 
para que sea gestionada por una consola 
SNMP con la versión del protocolo 2: SNMPvz2, 


En primer lugar, instalaremos el software 
SNMIP en la plataforma sobre la que se ejecuta 
Asterisk, en este caso, Ubuntu Server 


A continuación, una vez que instalamos el soft- 
ware SNMP en nuestra plataforma, tenemos 
que configurarlo. Para esto, debemos seguir el 
procedimiento explicado en el Paso a Paso 2. 
Veremos que es algo muy sencillo, 





Está fuera del propósito de este libro la implementación y configuración de una plata- 
forma de gestión. Si no disponemos de una, podemos instalar algún software de prue- 


ba; y si la tenemos, consultar la documentación para configurar el lado consola. 
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Instale los paquetes necesarios 
a través del siguiente comando: 
IF Sudo apt-get install 
snmp libsnmp-dev snmpd 


11d Option lectios 5 "fo. 
2 Applications eS pa Configure y verifique la 
: Call detal! Recording A E E 
Chemo! Event Leg Io! E disponibilidad del res_ 
ans la * ON res _jabhber 
blalplas Functions A snmp: dk cd -/src/sistema_ 
AAA asterisk/asterisk/1.8 
Depends on: reteampiE) 
Conflicts elth! MA iF ./configure 
pport Lesel: extended 
IF make menuselect 
3 


Realice la instalación mediante el 
comando: dk sudo make install. 
Cree el archivo res_snmp.conf: 
IF cp -/src/sistema_asterisk/ 
asterisk/1.8/configs/res_ 
snmp.conf.sample /etc/ 





asterisk/res_snmp.conf 
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PASO A PASO /2 


Configuración del SNMP 





Edite el archivo res_snmp. 
conf mediante el comando: 

iF sudo nano res_snmp. 
conf.A continuación, en la 
sección [general], modifique 
los siguientes parámetros : 
subagent=yes 
enabled-yes 


Inicie Asterisk a través del 
comando: dk asterisk -c. 

Luego, recargue el módulo res_ 
snmp.so: CLI> module unload 
res_snmp.so 

CLI> module load res_snmp.so 


Cree el archivo de configuración SNMP, 
snmpd.conf: ¿cd /etc/snmp 

iF sudo cp snmpd.sample snmpd. 
conf 

Edite la configuración del SNMPd: 

if sudo nano snmpd.conf 

En el archivo snmpd.conf, ingrese lo 
que muestra la imagen. 
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Acceda a http:/ 
wiki.asterisk.org/ 
wiki/display/AST/ 
Asterisk+MIB+Definitions y 
copie el contenido a un archivo 


TXT. /usr/share/snmp/mibs/ 
asterisk-mib.txt 


Ahora ingrese en http:/wiki. 
asterisk.org/wiki/display/ 
AST/Digium+MIB+Definitions 
y copie el contenido a un archivo 


TXT: /usr/share/snmp/mibs/ 
digium-mib.txt 


Importe las MIB: 

dk export MIBS=+ASTERISK-MIB 
IF export MIBS=+DIGIUM-MIB 
Para finalizar, reinicie el demonio 


snmpd: + sudo /etc/init.d/snmpd 
restart 
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Figura 1. Para usar las entradas del archivo 


debemos quitarle los comentarios. 


Luego de realizar esta configuración, podemos 
dar de alta el servidor Asterisk en una plata- 
forma de gestión, utilizando public como valor 
de comunidad (community) y la dirección IP de 
nuestra interfaz de red. 


Es importante aclarar que gran parte del pro- 


ceso depende de los permisos bajo los que co- 
rren el demonio snmpd y la aplicación Asterisk. 


Registro de 
información 


Por lo general, la información de registro se en- 
cuentra en archivos que se conocen como logs. 


DD) DEBUG | 


La mayoría de los sistemas suele contener esta 
clase de archivos y la funcionalidad para guar- 
dar en ellos la información pertinente. Por ejem- 
plo, Linux, como sistema operativo, tiene un 
subsistema de logging destinado a recopilar di- 
ferente tipo de información, que abarca desde 
su funcionamiento hasta el historial de acceso 
de los usuarios. 


Asterisk también cuenta con una herramien- 
ta para la creación, el mantenimiento y la con- 
sulta de estos logs, que a continuación vere- 
mos en detalle. 


CONFIGURACIÓN Y ANÁLISIS 

DE EVENTOS 

En Asterisk, el archivo para el registro de in- 
formación se encuentra dentro del directorio / 
etc/asterisk, y su configuración consiste en 
indicar el tipo de información que se va a reco- 
pilar y el nombre de los archivos donde se alma- 
cenará. El nombre puede ser cualquier palabra, 
pero es conveniente que utilicemos alguna que 
refleje los datos que almacena el archivo. No 
olvidemos que estos subsistemas se configu- 
ran, en general, durante la instalación e imple- 
mentación del sistema, y serán requeridos tiem- 
po después. Tal vez otras personas tengan que 





Es la acción de reparar los problemas del sistema. Las sesiones de debugging son las 


que se llevan adelante cuando se está buscando la solución a algún inconveniente que 


tenemos en el sistema. No sirve para errores relacionados con el Dialplan. 
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revisarlos en busca de alguna pista para resol- 


ver un problema o para desarrollar alguna apli- 


En la Tabla 1 detallamos los diferentes tipos 
cación sobre Asterisk. 


de información que podemos incluir en los 
archivos de registro. 


TIPO DE INFORMACIÓN 





DESCRIPCIÓN 


notice 


Son mensajes que brindan información; por lo general, no requieren 
intervención. 


warning 


El evento que dispara estos mensajes puede alterar el normal funciona- 
miento del sistema. Su gravedad debe evaluarse sobre la base de la infor- 
mación contenida en el archivo, dado que a veces responden a configura- 

ciones explícitas. Estos mensajes, en general, requieren intervención. 
error 


Estos mensajes informan de problemas en el sistema. Requieren interven- 
ción inmediata. 
verbose 


Es uno de los tipos preferidos por los implementadores. Permite registrar 


toda clase de inconvenientes, pero dejarlo activo sin utilizarlo puede cau- 
sar problemas. 
debug 


Este tipo de información se utiliza durante el análisis de problemas. Su uso 


debería ser supervisado y solo emplearse cuando realizamos un análisis. 
dtmf 


Es un tipo específico de información involucrado en el encaminamiento in- 
terno de las llamadas. 
fax 


Otro tipo específico de información relacionada con la tecnología para aten- 
der un fax (recursos como res_fax_spandsp). 
* (asterisco) 


Esta selección hará que todos los tipos de mensajes se almacenen. Se po- 
dría emplear en caso de que no encontráramos la información necesaria, 
pero hay que ser cuidadosos. 
AÁÁÁAÁAÁAÁ_Á_<_ÁAAÓA_<_ÓA<=AAAAAAÓAAA A AA A A A A A A | 
Tabla 1. Solo debemos almacenar la información que nos resulte de utilidad. 
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Los tipos debug y verbose solo deben utilizar- 
se dentro de sesiones de búsqueda y recolec- 
ción de evidencia para el análisis de problemas, 
porque generan gran cantidad de información 
detallada y pueden llenar el disco en pocos días, 
dependiendo del tamaño del sistema. 


El resto, salvo * (asterisco), puede usarse con 
discreción, pero siempre, como tarea del admi- 
nistrador de la plataforma. Es necesario controlar 
el tamaño de los archivos de logs en disco, por- 
que aunque no detengan al sistema, pueden re- 
ducir su rendimiento a medida que crecen. Solo 
habilitemos el tipo de datos necesario y mínimo, 
y controlemos los archivos. Si estos crecen mucho 
o en forma acelerada, quitemos los tipos no es- 
trictamente necesarios, o guardemos la informa- 
ción en un soporte de respaldo y borremos los ar- 
chivos. El sistema volverá a crearlos. 


La búsqueda y el análisis de los eventos en 
los archivos de registro se asemejan a la ru- 
tina que los administradores de sistemas rea- 
lizan para resolver los inconvenientes de sus 
instalaciones. Lo importante es tener paráme- 
tros que permitan filtrar la información para 
reducir la búsqueda. Algunos de los más em- 
pleados son el horario y palabras clave como 


») DEBUG ll 


nombres de variables o subsistemas; todo lo 
que conduzca a reducir el tamaño de los datos 
por analizar. Las herramientas que se emplean 
para hacerlo van desde programas especializa- 
dos en análisis de registros hasta los coman- 
dos de Linux: less, tail y grep. 


Es posible enviar los eventos al registro central de la 
plataforma, el syslog o rsyslog. Para esto, debe- 
mos habilitar esta acción en los archivos logger. 
conf y /etc/rsyslog.conf, o /etc/syslog. 
conf y /etc/rsyslog.d/50-default.conf, 
si queremos redireccionar los mensajes a archivos 
específicos. En nuestro caso enviaremos todos los 
mensajes al archivo por defecto de syslog. 


Los archivos rsyslog.conf, syslog.conf y 
50-default.conf no pertenecen al grupo de ar- 
chivos de configuración de Asterisk, sino a la pla- 
taforma, en este caso, Ubuntu Server. Podemos ver 
los canales de registro que tenemos configurados 
en un sistema mediante el comando CLl 1ogger 
show channels. 


En La Figura 4 se muestra el canal de syslog 
Local7, que es otro de los canales de usua- 
rio para redireccionar los mensajes (van desde 
Local0 hasta Local7). 





Cuando utilizamos el tipo de información debug, debemos recordar desactivarlo al 
finalizar, porque estos datos se guardan en un archivo que puede crecer hasta consumir 


todo el espacio de disco, lo que hará que el sistema se detenga abruptamente. 
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Mo such file or directory 


¿kB hum . a 
kubuntu: -var- log erizk£ 
p “Yare asterizk5 
A a EAS terizk5 
E A A A 
ning on TCP sockel. 
[Feb ¿1 £¿£:17:4£1 ERROR[1300] pbx_dundi.c! 
Address alreado in use 
[Feb ¿22:17:431 NOTICE[13861 pbx_ae 
[Feh 7 17:331 NOTICE[135H81 phx_: 
ame * sterlsk-"extenslons.ael" 
A 17:4391 HOTICE[1301 phx_ael.c! 
dd ES 
[Feb ¿ :17:4341 HOTICE[1300] pbx_ael. 
name '*elc-aslerizkreztensionz.ael”. 
[Feb £ 243] HOTICE[1300] pbx_ael. 
ame * rl rPizkrextensions.ael'. 
[Feb 27 E A SA 
name * eL erizksrexlensions.ael'. 
[Feb 27 17:13] ERRORC[13861 codec dahdi. 
A ion denied 
[Feb ¿7 22:18:041 UARNIARGI1I3867] loader.c: 


nd 


ETE 
suarioass 


: EL load process! 


: MEL load process! 


mraslerisk 


tall -10 messages 
31P TCP Server start Failed. Hot liste 


Unable to bind to 0.0.0.0 port 45260: 


: Starting EL load procezz. 
AA E AA E IIA 


EL Ilnád process! checked eonfig File 
conpiled config file 
nerged config file n 
MEL load process: verificd config file 
NS A A A ed 


Unload falled, “rez could not be Fou 


usuarioasteriskBubuntu:-«var-lograsterisk 5 _ 


GNU nano Z.Z.6 


this is another reason not to have debuy 


gou are in Che process of debugging a specif ía 


¿debug 
console 
¿console 
NOxiaqes; 
verbose 
¿fu 11 


+ debug 
notice, ,varning,error,dtaf 
notice ,varning error, debug 
mor É A y UA PELA NA] serruar 
notice, ,uarning,error,verbose 


¿guslog keyword 


=yslog.localó0 => notice, ,varning.error 


8 Get Help BN Urite0ut GB Read File] 
Exit TES EY Where Is 


.registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering pdu failed: 263 
registering TA 


Asterisk Ready. 

AD SS A ES 
Channel Type 
syslog.local? 
/var/log/asterisk/verbose 
ERBOSE 


/var/log/asterisk/messages 


File 


File 


Console 





Sys log 


File: /etcrasteriskslogger.conf 


node on a production systen unless 
ISSUE. 


notice, ,uarning, error, debug, verbose, ,dtnf ,fax 


This special keyuord logs to syslog facility 


Preu Paye P Cut Text ' ATEN 
Next Page UnCut Text To Spell 


MATES Conf iguration 


Enabled 
Enabled 


NOTICE WARNING 
NOTICE WARNING 


Enabled 
Enabled 


NOTICE WARNING 
NOTICE WARNING 





Filtramos los 
últimos 10 
registros en el 
archivo messages. 


Debemos 
habilitar la última 
línea para usar 
el syslog desde 
Asterisk. 


El tipo 
de canal muestra 
el destino del 
mensaje generado 
por el logger de 
Asterisk. 
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4N reload) at line 35. 
[Feb 24 19:51:191 VARNING[15491 chan_dahdi.c: Ignoring any changes to 'hasiax' 
on reload) at line 39. 
DA ESE LESS EA ODA A ES ENE 
r' (on reload) at line 47. 

24 19:51:19] NOTICE[15491 chan_skinny.c: Configuring skinny from skinny.co 


Figura 5. Los 
mensajes de 
Asterisk aparecen 


24 19:51:20] ERROR[15491] codec_dahdi.c: Failed to open /dev/dahdi/transcod 


such file or directory 

"Ar a e A EA) EAS 

24 19:51:20] NOTICE[15491 pbx_ael. 

* /etc/asterisk/extensions.ael'. 

¿1 19:51:20] NOTICE[15491 pbx_ael. 

"/etc/asterisk/extensions.ael'. 

As SU ls E EA O LO A 
name '/etc/asterisk/extensions.ael'. 
[Feb 24 19:51:20] NOTICE[15491 pbx_ael. 
ame '/etc/asterisk/extensions.ael'. 


: AEL load process: 


en el archivo 


: Starting ÁEL load process. 
: AEL load process: parsed config file 


syslog. 


IS A e 1d 


compiled config fil 


: AEL load process: merged config file 


DAA EEN IAE ANA IA AAA 


name '/etc/asterisk/extensions.ael'. 


[Feb 24 19:52:341 WARNING[15911 chan_oss.c: Unable to re-open DSP device /dev/d 


p: No such file or directory 


DAA JU e ETA IA E ESA AAA AENA ASIS 


t not present 
usuarioasteriskBubuntu:/var/log/asterisk$ zA 


Otros 
registros 


Asterisk también puede registrar el tratamien- 
to de las llamadas. Estos registros se usan 
para analizar el funcionamiento interno del 
sistema, realizar el seguimiento de problemas, 
y recopilar información con el fin de facturar 
las llamadas y efectuar el planeamiento de 
la capacidad. A continuación, conoceremos 
algunos de estos registros. 


REGISTRO CDR (CALL DETAIL RECORDS) 


El registro CDR recopila eventos relacionados 
con la evolución de las llamadas. Si bien 


O MENUSELECT 





la información es bastante detallada, la 
organización y la segmentación de los eventos 
no son adecuadas para un eficiente análisis 
de problemas. En la siguiente dirección, 
podemos ver los campos utilizados en los CDR: 
https://wiki.asterisk.org/wiki/display/AST/ 
CDR+Fields. 


Aplicación CDR() 

Esta aplicación nos permite acceder a los registros 
CDR y establecer los valores de sus campos des- 
de el Dialplan. También podemos definir campos 
especiales, que no están establecidos por defecto. 


Para configurarla, utilizamos el archivo cdr.conf, 
que, como los demás archivos de configuración, 





Con la utilidad Menuselect, podemos configurar el sistema desde el punto de vista de la 
plataforma. Los componentes con el prefijo XXX son los que no se pudieron cargar por un 


problema de dependencias. Si los seleccionamos, veremos las dependencias y su estado. 





126 RedUSERS: 


Otros registros 





GNU nano 2.2.6 File: setesasterisksextensions.conf Modified 


En 
el archivo 


¿own dialltone and converse uvith the PEX only afler a number is complete, are 
¿ generally unaffected by ignorepat (unless DIS or another method is used to 
¿ qenerale a diallone afler ansuering the channel) 


extensions.conf 
encontramos usos ; Sample entries for extensions .conf 
' linternos ] 
sugeridos para la A A E 
a Eg sane => n,Set(íCDRIrate)-0.04) 
aplicación CDR(. sane => m,Hangup()_ 


[dund i-e161- canonica!] 
¿include => stdexten 


; List canonical entries here 


¿exten => 12561286000,1,603ub1(6000,stdextent1nxXZ+f00)) 


j Gel Help dl Uritelut Read File ] Preu Page 1 Cut Text ]Í TE ES 
Exit JENS tar A ES Next Page UnCut Text To Spell 





posee identificadores de secciones. Los detalles de e cdt_adaptive_odbc 
los parámetros del archivo pueden obtenerse en el e cdr_csv 
sitio oficial de Asterisk. El archivo que viene confi- e cdr_custom 
gurado por defecto servirá para iniciar el servicio y e cdr_manager 
registrar información básica de las llamadas. e cdr_mysql 
e cdr_odbc 
Para que el servicio sea funcional, es necesa- e cdr_pgsq]l 
rio definir una plataforma donde almacenar e cdr_radius 
los eventos. Para esto existen varias alterna- e cdr_sqlite 
tivas, pero solo veremos las más comunes. Las cdr_sqlite3_custom 
opciones para registrar los eventos generados e cdr_syslog 
por el subsistema CDR son las siguientes: e cdr_tds 


GA nano 2.2.6 File; «elecrasterisk-cdr.conf Hodified 


¿ ECHOOSIH6 A COR “BECKEND”  Cuhat kind of output to gencratel 


A A AT A A A TE 

: defined in this file, or that the appropriote config file existe, and has the 
¿ proper definilions in iL. 1 there are any problems, usually, Lhe entriy u111 
¿ sldlently ignored, and you get no output. 


: lso, please nole Lhal yo can qenerale COR records in as mámp Formales as ajo 
¿mulsh. 1f you configure 5 different CR formats, then cach event ulll be logged 

La ¿ din 3 different placest In the example config files. all formats are commented 
¿mul excepl for Lhe cdr=csv Formal. 


forma de registrar 


: Mere are all the possible back ends: 


los eventos H co4,. custom. manager, odbc. pgsgl. radlus, sqlite. tdz 
o lalzo, myeql is available via Lhe aslerisk-addons, due Lo | icensilll 
CDR también se E requirements) 


AA A A E A A A 
configura en el 
Exit 





Get Help AA AAA MI Ea A 


. y Justify Where ls A CA” TI 
archivo cdr.conf : E 
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Esta funcionalidad permite el registro en ba- 
ses de datos de diferentes formatos. CSV 
(Comma Separated Values) es uno de los 
más utilizados; conoceremos algunas de sus 
características. 
El archivo cdr_csv en el que se almacenan 
los registros se denomina Master.csv y Se 
encuentra en el directorio /var/log/asterisk/ 
edr-csv. Una vez que se habilita el registro CDR, 
este formato queda operativo, sin necesidad de 
ninguna configuración, aunque existen opciones 
para controlar su comportamiento. 


Para probar este almacenamiento, creamos la 
extensión 204 en el contexto [internos] y 
la llamamos con el comando CLI> console 
dial 204internos. El resultado se observa 
en la Figura 8. Este formato puede recuperarse 
y es posible acceder a él con aplicaciones como 
Microsoft Excel. 


REGISTRO CEL (CHANNEL EVENT LOGGING) 
El sistema CEL nace a raíz de la necesidad 
de contar con una forma más detallada de 


usuarioasteriskGubuntu:/var/log/asterisk/cdr-csuó$ 
usuarioasteriskGubuntu:/var/log/asterisk/cdr-csuó$ 
usuarioasteriskGubuntu:/var/log/asterisk/cdr-csuó$ 
usuarioasteriskGubuntu:/var/log/asterisk/cdr-csuó$ 
usuarioasteriskGubuntu:/var/log/asterisk/cdr-csuó$ 
usuarioasteriskGubuntu:/var/log/asterisk/cdr-csuó$ 
usuarioasterisktGubuntu:/var/log/asterisk/cdr-csu$ 
usuarioasteriskGubuntu:/var/log/asterisk/cdr-csu$ 


0,09 0243", "pruebas”,”","Console/dsp”," 
03-01 05:00:33",*"2013-03-01 05:00:34" 


" "Hangup”,” 


3- 
lo 
Ue Dai 
3-03-01 05:01:27","2013-03-01 05:01:27" 
IDA 
a Ue Da 


","Console/dsp”,"","Hangup”,"” 


","Console/dsp"," 
=02 22:26:36","2013-03-02 22:26:37" 


o Hangup”,"" 
3- 

",%","213","pruebas”,"","Console/dsp"”,"","Hangup”,"" 
PARA ANA He ds DPI O le ls 0 TO PARA ARA Ms ds CIAO Ly DO 
09.1%," 


aster.csu (END) 
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", "2013-03-01 05:00: 
,1,1,"ANSUERED" 


,1,0,"ANSUERED" 


,1,1,"ANSUERED"” 





registro de actividades. Si bien el CDR resulta 
muy útil y simple de implementar, solo es 
apropiado mientras la instalación tiene una 
tamaño reducido; a medida que se hace más 
compleja y se explotan más características, se 
hace necesario contar con herramientas que 
acompañen este desarrollo. El objetivo de este 
registro y su lógica de funcionamiento son 
similares a lo explicado para el CEL. 


El archivo cel.conf es el que permite 
controlar el comportamiento del susbsistema 
y una serie de plataformas para registrar 
los eventos generados. Los formatos y 
plataformas admitidos son los que detallamos 
a continuación: 


cel_odbc 
cel_custom 
cel_manager 
cel_pgsql 
cel_radius 
cel_sqlite3_custom 
cel_tds 


a 
, “DOCUMENTATION”, "1362114€ 


, 2013-03-01 05:01:26","201 


, "DOCUMENTATION", "13621140 
"2013-03-02 22:26:36","201 Figura 8. Los 
, "DOCUMENTATION", "13622631 

eventos se 


Ah E: PARA ARA TE 
”, "DOCUMENTATION”," 


So Al 


13622637 almacenan en 


formato CSV. 
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tros registros 





Los formatos cel_manager o custom ver 
emiten registros CEL sobre la AMI. Para poder 
utilizarlos, es necesario habilitar el uso de CEL 


PASO A PASO /3 


Habilitar el backend cel_manager 


y de AMI. En el siguiente Paso a Paso 
veremos en detalle cuál es el procedimiento 
que debemos seguir para poder habilitarlos. 
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Edite el archivo cel.conf 

a través del comando: 

dF Sudo nano /etc/asterisk/ 
cel.conf. 

Luego, habilite los siguientes 
parámetros en las secciones 
indicadas: 

[general] 

enable-yes 
events=CHAN_START,CHAN_ 
END, ANSWER, HANGUP 
[manager] 

enabled=yes 


Genere una extensión de prueba en el 
Dialplan: 

IF sudo nano /etc/asterisk/ 
extensions.conf. 

Agregue las siguientes líneas y guarde 
el archivo: 

[pruebas] 

exten => 213,1,Answer() 

same => 
n,CELGenUserEvent(Custom 
Event, Prueba cel_manager) 
same => n,Hangup() 
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PASO A PASO /3 (cont.) 





Ejecute Asterisk con consola local y 
nivel de verbose 3: 

F asterisk -cvvv. 

Por último, ejecute la extensión 213: 
*CLI> console dial 213€pruebas 





Los eventos CEL generados en esta prueba son Esto podemos verlo en la Figura 9, que muestra 
almacenados por defecto en formato CSV. un despliegue del archivo Master.csv. 





A 9 


Ñ 
49",0,0,"AMSU 
LTD 


Figura 9. Los eventos CEL se almacenan en 
formato CSV. 


O RESUMEN 


Para poder gestionar un sistema necesitamos monitorear su funcionamiento. Por eso, 
en este capítulo aprendimos a habilitar el monitoreo del sistema y el registro de infor- 
mación que se empleará, tanto para la gestión operativa y la planificación de capaci- 





dad, como para el mantenimiento y seguimiento de problemas. 
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